FieldSymbol

FieldSymbol class

Implementa un campo SIMBOLO.

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 sull’interlinea del paragrafo.
End { get; }Ottiene il nodo che rappresenta la fine del campo.
FontName { get; set; }Ottiene o imposta il nome del carattere 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 aFieldFormat oggetto che fornisce accesso digitato alla formattazione del campo.
IsAnsi { get; set; }Ottiene o imposta se il codice carattere viene interpretato come 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 deve ricalcolare il risultato).
IsShiftJis { get; set; }Ottiene o imposta se il codice carattere viene interpretato come il 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ò esserenullo .
Start { get; }Ottiene il nodo che rappresenta l’inizio del campo.
virtual Type { get; }Ottiene il tipo di campo Microsoft Word.

Metodi

NomeDescrizione
GetFieldCode()Restituisce il testo compreso tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi secondari.
GetFieldCode(bool)Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore).
Remove()Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo figlio del suo nodo genitore, restituisce il paragrafo genitore. Se il campo è già stato rimosso, restituiscenullo .
Unlink()Esegue lo scollegamento del campo.
Update()Esegue l’aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento.
Update(bool)Esegue un aggiornamento del campo. Genera un risultato 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 SIMBOLO per visualizzare un singolo carattere.
// 1 - Aggiungi un campo SIMBOLO che visualizza il simbolo © (Copyright), specificato da un codice carattere ANSI:
FieldSymbol field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

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

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

builder.Writeln(" Line 1");

// 2 - Aggiungi un campo SIMBOLO che visualizzi il simbolo ∞ (Infinito) e modifica il suo aspetto:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

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

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

// Possiamo impostare questo flag per i simboli alti per fare 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 visualizzi il carattere あ,
// con un carattere 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