FieldMergeBarcode
Contenu
[
Cacher
]FieldMergeBarcode class
Implémente le champ MERGEBARCODE.
Pour en savoir plus, visitez leTravailler avec les champs article de documentation.
public class FieldMergeBarcode : Field
Constructeurs
| Nom | La description |
|---|---|
| FieldMergeBarcode() | Default_Constructor |
Propriétés
| Nom | La description |
|---|---|
| AddStartStopChar { get; set; } | Obtient ou définit s’il faut ajouter des caractères de démarrage/arrêt pour les types de codes-barres NW7 et CODE39. |
| BackgroundColor { get; set; } | Récupère ou définit la couleur d’arrière-plan du symbole du code-barres. Les valeurs valides sont comprises entre [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; } | Récupère ou définit le style d’un code de cas pour le code-barres de type 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 du 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 le 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 n’est pas valide. |
| ForegroundColor { get; set; } | Obtient ou définit la couleur de premier plan du symbole du code-barres. Les valeurs valides sont comprises entre [0, 0xFFFFFF] |
| Format { get; } | Obtient unFieldFormatobjet 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 (obsolète) 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; } | Récupère 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 qui se trouve entre le séparateur de champ et la fin du champ. |
| ScalingFactor { get; set; } | Obtient ou définit un facteur d’échelle pour le symbole. La valeur est exprimée en points de pourcentage entiers et les valeurs valides sont [10, 1000] |
| Separator { get; } | Récupère le nœud représentant le séparateur de champ. Peut êtrenul . |
| Start { get; } | Obtient le nœud qui représente le début du champ. |
| SymbolHeight { get; set; } | Récupère ou définit la hauteur du symbole. Les unités sont en TWIPS (1/1440 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 du 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 immédiatement 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. Lève une requête si le champ est déjà en cours de mise à jour. |
| Update(bool) | Effectue une mise à jour du champ. L’erreur est générée si le champ est déjà en cours de mise à jour. |
Remarques
Fusionner un code-barres.
Exemples
Montre comment effectuer un publipostage sur des codes-barres ITF14.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insérez 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 « MyITF14Barcode » d'une source de données de fusion en codes-barres ITF14.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "ITF14";
field.BarcodeValue = "MyITF14Barcode";
field.CaseCodeStyle = "STD";
Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE MyITF14Barcode ITF14 \\c STD", field.GetFieldCode());
// Créez un DataTable avec une colonne portant le même nom que 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-barres ITF14 avec la valeur de la ligne fusionnée.
DataTable table = new DataTable("Barcodes");
table.Columns.Add("MyITF14Barcode");
table.Rows.Add(new[] { "09312345678907" });
table.Rows.Add(new[] { "1234567891234" });
doc.MailMerge.Execute(table);
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[0].Type);
Assert.AreEqual("DISPLAYBARCODE \"09312345678907\" ITF14 \\c STD",
doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[1].Type);
Assert.AreEqual("DISPLAYBARCODE \"1234567891234\" ITF14 \\c STD",
doc.Range.Fields[1].GetFieldCode());
doc.Save(ArtifactsDir + "Field.MERGEBARCODE.ITF14.docx");
Montre comment effectuer un publipostage sur les codes-barres CODE39.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insérez 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 « MyCODE39Barcode » d'une source de données de fusion en codes-barres CODE39.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "CODE39";
field.BarcodeValue = "MyCODE39Barcode";
// Modifiez son apparence pour afficher les caractères de début/fin.
field.AddStartStopChar = true;
Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE MyCODE39Barcode CODE39 \\d", field.GetFieldCode());
builder.Writeln();
// Créez un DataTable avec une colonne portant le même nom que 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-barres CODE39 avec la valeur de la ligne fusionnée.
DataTable table = new DataTable("Barcodes");
table.Columns.Add("MyCODE39Barcode");
table.Rows.Add(new[] { "12345ABCDE" });
table.Rows.Add(new[] { "67890FGHIJ" });
doc.MailMerge.Execute(table);
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[0].Type);
Assert.AreEqual("DISPLAYBARCODE \"12345ABCDE\" CODE39 \\d",
doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[1].Type);
Assert.AreEqual("DISPLAYBARCODE \"67890FGHIJ\" CODE39 \\d",
doc.Range.Fields[1].GetFieldCode());
doc.Save(ArtifactsDir + "Field.MERGEBARCODE.CODE39.docx");
Montre comment effectuer un publipostage sur des codes-barres EAN13.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insérez 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 « MyEAN13Barcode » d'une source de données de fusion en codes-barres EAN13.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "EAN13";
field.BarcodeValue = "MyEAN13Barcode";
// Affiche la valeur numérique du code-barres sous les barres.
field.DisplayText = true;
field.PosCodeStyle = "CASE";
field.FixCheckDigit = true;
Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE MyEAN13Barcode EAN13 \\t \\p CASE \\x", field.GetFieldCode());
builder.Writeln();
// Créez un DataTable avec une colonne portant le même nom que 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-barres EAN13 avec la valeur de la ligne fusionnée.
DataTable table = new DataTable("Barcodes");
table.Columns.Add("MyEAN13Barcode");
table.Rows.Add(new[] { "501234567890" });
table.Rows.Add(new[] { "123456789012" });
doc.MailMerge.Execute(table);
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[0].Type);
Assert.AreEqual("DISPLAYBARCODE \"501234567890\" EAN13 \\t \\p CASE \\x",
doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[1].Type);
Assert.AreEqual("DISPLAYBARCODE \"123456789012\" EAN13 \\t \\p CASE \\x",
doc.Range.Fields[1].GetFieldCode());
doc.Save(ArtifactsDir + "Field.MERGEBARCODE.EAN13.docx");
Montre comment effectuer un publipostage sur des codes-barres QR.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insérez 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";
// Appliquer 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 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");
Voir également
- class Field
- espace de noms Aspose.Words.Fields
- Assemblée Aspose.Words
