FieldMergeBarcode
Contenuti
[
Nascondere
]FieldMergeBarcode class
Implementa il campo MERGEBARCODE.
Per saperne di più, visita ilLavorare con i campi articolo di documentazione.
public class FieldMergeBarcode : Field
Costruttori
| Nome | Descrizione |
|---|---|
| FieldMergeBarcode() | Default_Costruttore |
Proprietà
| Nome | Descrizione |
|---|---|
| AddStartStopChar { get; set; } | Ottiene o imposta se aggiungere caratteri di inizio/fine per i tipi di codice a barre NW7 e CODE39. |
| BackgroundColor { get; set; } | Ottiene o imposta il colore di sfondo del simbolo del codice a barre. I valori validi sono compresi nell’intervallo [0, 0xFFFFFF] |
| BarcodeType { get; set; } | Ottiene o imposta il tipo di codice a barre (QR, ecc.) |
| BarcodeValue { get; set; } | Ottiene o imposta il valore del codice a barre. |
| CaseCodeStyle { get; set; } | Ottiene o imposta lo stile di un codice a barre per il tipo di codice a barre ITF14. I valori validi sono [STD|EXT|ADD] |
| DisplayResult { get; } | Ottiene il testo che rappresenta il risultato del campo visualizzato. |
| DisplayText { get; set; } | Ottiene o imposta se visualizzare i dati del codice a barre (testo) insieme all’immagine. |
| End { get; } | Ottiene il nodo che rappresenta la fine del campo. |
| ErrorCorrectionLevel { get; set; } | Ottiene o imposta un livello di correzione degli errori del codice QR. I valori validi sono [0, 3]. |
| FixCheckDigit { get; set; } | Ottiene o imposta se correggere la cifra di controllo se non è valida. |
| ForegroundColor { get; set; } | Ottiene o imposta il colore di primo piano del simbolo del codice a barre. I valori validi sono compresi nell’intervallo [0, 0xFFFFFF] |
| Format { get; } | Ottiene unFieldFormatoggetto che fornisce accesso tipizzato alla formattazione del campo. |
| IsDirty { get; set; } | Ottiene o imposta se il risultato corrente del campo non è più corretto (obsoleto) a causa di altre modifiche apportate al documento. |
| IsLocked { get; set; } | Ottiene o imposta se il campo è bloccato (non dovrebbe ricalcolare il suo risultato). |
| LocaleId { get; set; } | Ottiene o imposta l’LCID del campo. |
| PosCodeStyle { get; set; } | Ottiene o imposta lo stile di un codice a barre del punto vendita (tipi di codice a barre UPCA|UPCE|EAN13|EAN8). I valori validi (senza distinzione tra maiuscole e minuscole) sono [STD|SUP2|SUP5|CASE]. |
| Result { get; set; } | Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo. |
| ScalingFactor { get; set; } | Ottiene o imposta un fattore di scala per il simbolo. Il valore è espresso in punti percentuali interi e i valori validi sono [10, 1000] |
| Separator { get; } | Ottiene il nodo che rappresenta il separatore di campo. Può esserenull . |
| Start { get; } | Ottiene il nodo che rappresenta l’inizio del campo. |
| SymbolHeight { get; set; } | Ottiene o imposta l’altezza del simbolo. Le unità sono in TWIPS (1/1440 di pollice). |
| SymbolRotation { get; set; } | Ottiene o imposta la rotazione del simbolo del codice a barre. I valori validi sono [0, 3] |
| virtual Type { get; } | Ottiene il tipo di campo di Microsoft Word. |
Metodi
| Nome | Descrizione |
|---|---|
| GetFieldCode() | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è un separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi figlio. |
| GetFieldCode(bool) | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è separatore). |
| Remove() | Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo nodo figlio del suo nodo padre, restituisce il paragrafo padre. Se il campo è già stato rimosso, restituiscenull . |
| Unlink() | Esegue lo scollegamento del campo. |
| Update() | Esegue l’aggiornamento del campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
| Update(bool) | Esegue un aggiornamento di campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
Osservazioni
Stampa unione di un codice a barre.
Esempi
Mostra come eseguire una stampa unione sui codici a barre ITF14.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserire un campo MERGEBARCODE, che accetterà valori da un'origine dati durante una stampa unione.
// Questo campo convertirà tutti i valori nella colonna "MyITF14Barcode" di una sorgente dati di unione in codici a barre 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());
// Crea un DataTable con una colonna con lo stesso nome del BarcodeValue del nostro campo MERGEBARCODE.
// La stampa unione creerà una nuova pagina per ogni riga. Ogni pagina conterrà un campo DISPLAYBARCODE,
// che visualizzerà un codice a barre ITF14 con il valore della riga unita.
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");
Mostra come eseguire una stampa unione sui codici a barre CODE39.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserire un campo MERGEBARCODE, che accetterà valori da un'origine dati durante una stampa unione.
// Questo campo convertirà tutti i valori nella colonna "MyCODE39Barcode" di una sorgente dati di unione in codici a barre CODE39.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "CODE39";
field.BarcodeValue = "MyCODE39Barcode";
// Modificane l'aspetto per visualizzare i caratteri di inizio/fine.
field.AddStartStopChar = true;
Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE MyCODE39Barcode CODE39 \\d", field.GetFieldCode());
builder.Writeln();
// Crea un DataTable con una colonna con lo stesso nome del BarcodeValue del nostro campo MERGEBARCODE.
// La stampa unione creerà una nuova pagina per ogni riga. Ogni pagina conterrà un campo DISPLAYBARCODE,
// che visualizzerà un codice a barre CODE39 con il valore della riga unita.
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");
Mostra come eseguire una stampa unione su codici a barre EAN13.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserire un campo MERGEBARCODE, che accetterà valori da un'origine dati durante una stampa unione.
// Questo campo convertirà tutti i valori nella colonna "MyEAN13Barcode" di una sorgente dati di unione in codici a barre EAN13.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "EAN13";
field.BarcodeValue = "MyEAN13Barcode";
// Visualizza il valore numerico del codice a barre sotto le barre.
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();
// Crea un DataTable con una colonna con lo stesso nome del BarcodeValue del nostro campo MERGEBARCODE.
// La stampa unione creerà una nuova pagina per ogni riga. Ogni pagina conterrà un campo DISPLAYBARCODE,
// che visualizzerà un codice a barre EAN13 con il valore della riga unita.
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");
Mostra come eseguire una stampa unione sui codici a barre QR.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserire un campo MERGEBARCODE, che accetterà valori da un'origine dati durante una stampa unione.
// Questo campo convertirà tutti i valori nella colonna "MyQRCode" di una sorgente dati di unione in codici QR.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "QR";
field.BarcodeValue = "MyQRCode";
// Applica colori e ridimensionamenti personalizzati.
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();
// Crea un DataTable con una colonna con lo stesso nome del BarcodeValue del nostro campo MERGEBARCODE.
// La stampa unione creerà una nuova pagina per ogni riga. Ogni pagina conterrà un campo DISPLAYBARCODE,
// che visualizzerà un codice QR con il valore della riga unita.
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");
Guarda anche
- class Field
- spazio dei nomi Aspose.Words.Fields
- assemblea Aspose.Words
