FieldDisplayBarcode
Contenu
[
Cacher
]FieldDisplayBarcode class
Implémente le champ DISPLAYBARCODE.
Pour en savoir plus, visitez leTravailler avec des champs article documentaire.
public class FieldDisplayBarcode : Field
Constructeurs
| Nom | La description |
|---|---|
| FieldDisplayBarcode() | Default_Constructor |
Propriétés
| Nom | La description |
|---|---|
| AddStartStopChar { get; set; } | Obtient ou définit s’il faut ajouter des caractères Start/Stop pour les types de codes-barres NW7 et CODE39. |
| BackgroundColor { get; set; } | Obtient ou définit la couleur d’arrière-plan du symbole du code-barres. Les valeurs valides sont comprises dans la plage [0, 0xFFFFFF] |
| BarcodeType { get; set; } | Obtient ou définit le type de code-barres (QR, etc.) |
| BarcodeValue { get; set; } | Obtient ou définit la valeur du code-barres. |
| CaseCodeStyle { get; set; } | Obtient ou définit le style d’un code de cas pour le type de code-barres ITF14. Les valeurs valides sont [STD|EXT|ADD] |
| DisplayResult { get; } | Obtient le texte qui représente le résultat du champ affiché. |
| DisplayText { get; set; } | Obtient ou définit s’il faut afficher les données de code-barres (texte) avec l’image. |
| End { get; } | Obtient le nœud qui représente la fin du champ. |
| ErrorCorrectionLevel { get; set; } | Obtient ou définit un niveau de correction d’erreur du code QR. Les valeurs valides sont [0, 3]. |
| FixCheckDigit { get; set; } | Obtient ou définit s’il faut corriger le chiffre de contrôle s’il est invalide. |
| ForegroundColor { get; set; } | Obtient ou définit la couleur de premier plan du symbole du code-barres. Les valeurs valides sont comprises dans la plage [0, 0xFFFFFF] |
| Format { get; } | Obtient unFieldFormat objet qui fournit un accès typé au formatage du champ. |
| IsDirty { get; set; } | Obtient ou définit si le résultat actuel du champ n’est plus correct (périmé) en raison d’autres modifications apportées au document. |
| IsLocked { get; set; } | Obtient ou définit si le champ est verrouillé (ne doit pas recalculer son résultat). |
| LocaleId { get; set; } | Obtient ou définit le LCID du champ. |
| PosCodeStyle { get; set; } | Obtient ou définit le style d’un code-barres de point de vente (types de codes-barres UPCA|UPCE|EAN13|EAN8). Les valeurs valides (insensibles à la casse) sont [STD|SUP2|SUP5|CASE]. |
| Result { get; set; } | Obtient ou définit le texte situé entre le séparateur de champ et la fin du champ. |
| ScalingFactor { get; set; } | Obtient ou définit un facteur de mise à l’échelle pour le symbole. La valeur est en points de pourcentage entiers et les valeurs valides sont [10, 1000] |
| Separator { get; } | Obtient le nœud qui représente le séparateur de champ. Peut êtrenul . |
| Start { get; } | Obtient le nœud qui représente le début du champ. |
| SymbolHeight { get; set; } | Obtient ou définit la hauteur du symbole. Les unités sont en TWIPS (1/1440 de pouce). |
| SymbolRotation { get; set; } | Obtient ou définit la rotation du symbole du code-barres. Les valeurs valides sont [0, 3] |
| virtual Type { get; } | Obtient le type de champ Microsoft Word. |
Méthodes
| Nom | La description |
|---|---|
| GetFieldCode() | Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur). Le code de champ et le résultat du champ des champs enfants sont inclus. |
| GetFieldCode(bool) | Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur). |
| Remove() | Supprime le champ du document. Renvoie un nœud juste après le champ. Si la fin du champ est le dernier child de son nœud parent, renvoie son paragraphe parent. Si le champ est déjà supprimé, renvoienul . |
| Unlink() | Effectue la dissociation du champ. |
| Update() | Effectue la mise à jour du champ. Lance si le champ est déjà mis à jour. |
| Update(bool) | Effectue une mise à jour du champ. Lance si le champ est déjà mis à jour. |
Remarques
Insère un code-barres.
Exemples
Montre comment effectuer un publipostage sur des codes-barres QR.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insère un champ MERGEBARCODE, qui acceptera les valeurs d'une source de données lors d'un publipostage.
// Ce champ convertira toutes les valeurs de la colonne "MyQRCode" d'une source de données de fusion en codes QR.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "QR";
field.BarcodeValue = "MyQRCode";
// Applique des couleurs et une mise à l'échelle personnalisées.
field.BackgroundColor = "0xF8BD69";
field.ForegroundColor = "0xB5413B";
field.ErrorCorrectionLevel = "3";
field.ScalingFactor = "250";
field.SymbolHeight = "1000";
field.SymbolRotation = "0";
Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE MyQRCode QR \\b 0xF8BD69 \\f 0xB5413B \\q 3 \\s 250 \\h 1000 \\r 0",
field.GetFieldCode());
builder.Writeln();
// Créez un DataTable avec une colonne portant le même nom que la BarcodeValue de notre champ MERGEBARCODE.
// Le publipostage créera une nouvelle page pour chaque ligne. Chaque page contiendra un champ DISPLAYBARCODE,
// qui affichera un code QR avec la valeur de la ligne fusionnée.
DataTable table = new DataTable("Barcodes");
table.Columns.Add("MyQRCode");
table.Rows.Add(new[] { "ABC123" });
table.Rows.Add(new[] { "DEF456" });
doc.MailMerge.Execute(table);
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[0].Type);
Assert.AreEqual("DISPLAYBARCODE \"ABC123\" QR \\q 3 \\s 250 \\h 1000 \\r 0 \\b 0xF8BD69 \\f 0xB5413B",
doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[1].Type);
Assert.AreEqual("DISPLAYBARCODE \"DEF456\" QR \\q 3 \\s 250 \\h 1000 \\r 0 \\b 0xF8BD69 \\f 0xB5413B",
doc.Range.Fields[1].GetFieldCode());
doc.Save(ArtifactsDir + "Field.MERGEBARCODE.QR.docx");
Montre comment insérer un champ DISPLAYBARCODE et définir ses propriétés.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
FieldDisplayBarcode field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
// Vous trouverez ci-dessous quatre types de codes-barres, décorés de différentes manières, que le champ DISPLAYBARCODE peut afficher.
// 1 - QR code avec couleurs personnalisées :
field.BarcodeType = "QR";
field.BarcodeValue = "ABC123";
field.BackgroundColor = "0xF8BD69";
field.ForegroundColor = "0xB5413B";
field.ErrorCorrectionLevel = "3";
field.ScalingFactor = "250";
field.SymbolHeight = "1000";
field.SymbolRotation = "0";
Assert.AreEqual(" DISPLAYBARCODE ABC123 QR \\b 0xF8BD69 \\f 0xB5413B \\q 3 \\s 250 \\h 1000 \\r 0", field.GetFieldCode());
builder.Writeln();
// 2 - Code barre EAN13, avec les chiffres affichés sous les barres :
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "EAN13";
field.BarcodeValue = "501234567890";
field.DisplayText = true;
field.PosCodeStyle = "CASE";
field.FixCheckDigit = true;
Assert.AreEqual(" DISPLAYBARCODE 501234567890 EAN13 \\t \\p CASE \\x", field.GetFieldCode());
builder.Writeln();
// 3 - Code barre CODE39 :
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "CODE39";
field.BarcodeValue = "12345ABCDE";
field.AddStartStopChar = true;
Assert.AreEqual(" DISPLAYBARCODE 12345ABCDE CODE39 \\d", field.GetFieldCode());
builder.Writeln();
// 4 - Code-barres ITF4, avec un code cas spécifié :
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "ITF14";
field.BarcodeValue = "09312345678907";
field.CaseCodeStyle = "STD";
Assert.AreEqual(" DISPLAYBARCODE 09312345678907 ITF14 \\c STD", field.GetFieldCode());
doc.Save(ArtifactsDir + "Field.DISPLAYBARCODE.docx");
Voir également
- class Field
- espace de noms Aspose.Words.Fields
- Assemblée Aspose.Words
