FieldSymbol

FieldSymbol class

Implementa un campo SYMBOL.

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

public class FieldSymbol : Field

Costruttori

NomeDescrizione
FieldSymbol()Default_Costruttore

Proprietà

NomeDescrizione
CharacterCode { get; set; }Ottiene o imposta il valore del punto di codice del carattere in decimale o esadecimale.
DisplayResult { get; }Ottiene il testo che rappresenta il risultato del campo visualizzato.
DontAffectsLineSpacing { get; set; }Ottiene o imposta se il carattere recuperato dal campo influisce sulla spaziatura delle righe del paragrafo.
End { get; }Ottiene il nodo che rappresenta la fine del campo.
FontName { get; set; }Ottiene o imposta il nome del font del carattere recuperato dal campo.
FontSize { get; set; }Ottiene o imposta la dimensione in punti del font del carattere recuperato dal campo.
Format { get; }Ottiene unFieldFormatoggetto che fornisce accesso tipizzato alla formattazione del campo.
IsAnsi { get; set; }Ottiene o imposta se il codice del carattere viene interpretato come il valore di un carattere ANSI.
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).
IsShiftJis { get; set; }Ottiene o imposta se il codice carattere viene interpretato come valore di un carattere SHIFT-JIS.
IsUnicode { get; set; }Ottiene o imposta se il codice carattere viene interpretato come valore di un carattere Unicode.
LocaleId { get; set; }Ottiene o imposta l’LCID del campo.
Result { get; set; }Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo.
Separator { get; }Ottiene il nodo che rappresenta il separatore di campo. Può esserenull .
Start { get; }Ottiene il nodo che rappresenta l’inizio del campo.
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

Recupera il carattere il cui valore del punto di codice è specificato in decimale o esadecimale.

Esempi

Mostra come utilizzare il campo SIMBOLO.

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

// Di seguito sono riportati tre modi per utilizzare un campo SYMBOL per visualizzare un singolo carattere.
// 1 - Aggiungere un campo SIMBOLO che visualizzi il simbolo © (Copyright), specificato da un codice carattere ANSI:
FieldSymbol field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// Il codice carattere ANSI "U+00A9", ovvero "169" in formato intero, è riservato al simbolo di copyright.
field.CharacterCode = 0x00a9.ToString();
field.IsAnsi = true;

Assert.AreEqual(" SYMBOL  169 \\a", field.GetFieldCode());

builder.Writeln(" Line 1");

// 2 - Aggiungere un campo SIMBOLO che visualizzi il simbolo ∞ (infinito) e modificarne l'aspetto:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// In Unicode, il simbolo di infinito occupa il codice "221E".
field.CharacterCode = 0x221E.ToString();
field.IsUnicode = true;

// Cambia il font del nostro simbolo dopo aver utilizzato la mappa dei caratteri di Windows
// per garantire che il font possa rappresentare quel simbolo.
field.FontName = "Calibri";
field.FontSize = "24";

// Possiamo impostare questo flag per i simboli alti in modo che non spingano verso il basso il resto del testo sulla loro riga.
field.DontAffectsLineSpacing = true;

Assert.AreEqual(" SYMBOL  8734 \\u \\f Calibri \\s 24 \\h", field.GetFieldCode());

builder.Writeln("Line 2");

// 3 - Aggiungi un campo SIMBOLO che visualizza il carattere あ,
// con un font che supporta la codepage Shift-JIS (Windows-932):
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);
field.FontName = "MS Gothic";
field.CharacterCode = 0x82A0.ToString();
field.IsShiftJis = true;

Assert.AreEqual(" SYMBOL  33440 \\f \"MS Gothic\" \\j", field.GetFieldCode());

builder.Write("Line 3");

doc.Save(ArtifactsDir + "Field.SYMBOL.docx");

Guarda anche

FieldSubject Class FieldTA Class