FieldEmbed

FieldEmbed class

Implementa il campo EMBED.

public class FieldEmbed : Field

Costruttori

Nome Descrizione
FieldEmbed() Default_Costruttore

Proprietà

Nome Descrizione
DisplayResult { get; } Ottiene il testo che rappresenta il risultato del campo visualizzato.
End { get; } Ottiene il nodo che rappresenta la fine del campo.
Format { get; } Ottiene aFieldFormat oggetto che fornisce l’accesso digitato 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 ricalcolarne il risultato).
LocaleId { get; set; } Ottiene o imposta l’LCID del campo.
Result { get; set; } Ottiene o imposta il testo che si trova tra il separatore di campo e la fine del campo.
Separator { get; } Ottiene il nodo che rappresenta il separatore di campo. Può essere nullo.
Start { get; } Ottiene il nodo che rappresenta l’inizio del campo.
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 è presente alcun separatore). Sono inclusi sia il codice campo che il risultato 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’è un 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 padre, restituisce il suo paragrafo padre. Se il campo è già stato rimosso, ritorna nullo .
Unlink() Esegue lo scollegamento del campo.
Update() Esegue l’aggiornamento del campo. Genera se il campo è già in fase di aggiornamento.
Update(bool) Esegue un aggiornamento del campo. Genera se il campo è già in fase di aggiornamento.

Esempi

Mostra come vengono gestiti alcuni vecchi campi di Microsoft Word come SHAPE ed EMBED durante il caricamento.

// Apre un documento creato in Microsoft Word 2003.
Document doc = new Document(MyDir + "Legacy fields.doc");

// Se apriamo il documento di Word e premiamo Alt+F9, vedremo un campo SHAPE e un campo EMBED.
// Un campo SHAPE è l'ancora/canvas per un oggetto AutoShape con lo stile di wrapping "In linea con il testo" abilitato.
// Un campo EMBED ha la stessa funzione, ma per un oggetto incorporato,
// come un foglio di calcolo da un documento Excel esterno.
// Tuttavia, questi campi non verranno visualizzati nella raccolta Campi del documento.
Assert.AreEqual(0, doc.Range.Fields.Count);

// Questi campi sono supportati solo dalle vecchie versioni di Microsoft Word.
// Il processo di caricamento del documento convertirà questi campi in oggetti Shape,
// a cui possiamo accedere nella raccolta di nodi del documento.
NodeCollection shapes = doc.GetChildNodes(NodeType.Shape, true);
Assert.AreEqual(3, shapes.Count);

// Il primo nodo Shape corrisponde al campo SHAPE nel documento di input,
// che è la tela inline per la forma.
Shape shape = (Shape)shapes[0];
Assert.AreEqual(ShapeType.Image, shape.ShapeType);

// Il secondo nodo Shape è la forma stessa.
shape = (Shape)shapes[1];
Assert.AreEqual(ShapeType.Can, shape.ShapeType);

// La terza forma è il campo EMBED che conteneva il foglio di calcolo esterno.
shape = (Shape)shapes[2];
Assert.AreEqual(ShapeType.OleObject, shape.ShapeType);

Guarda anche