FieldDisplayBarcode

FieldDisplayBarcode class

Implementa il campo DISPLAYBARCODE.

Per saperne di più, visita ilLavorare con i campi articolo di documentazione.

public class FieldDisplayBarcode : Field

Costruttori

NomeDescrizione
FieldDisplayBarcode()Default_Costruttore

Proprietà

NomeDescrizione
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

NomeDescrizione
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

Inserisce un codice a barre.

Esempi

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");

Mostra come inserire un campo DISPLAYBARCODE e impostarne le proprietà.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

FieldDisplayBarcode field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);

// Di seguito sono riportati quattro tipi di codici a barre, decorati in vari modi, che il campo DISPLAYBARCODE può visualizzare.
// 1 - Codice QR con colori personalizzati:
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 - Codice a barre EAN13, con le cifre visualizzate sotto le barre:
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 - Codice a 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 - Codice a barre ITF4, con un codice caso specificato:
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");

Guarda anche

FieldDdeAuto Class FieldDocProperty Class