Vložit pole
Existuje několik různých způsobů, jak vložit pole do dokumentu:
- použití DocumentBuilder
- použití FieldBuilder
- použití Aspose.Words Document Object Model (DOM)
V tomto článku se budeme každým způsobem podrobněji zabývat a analyzovat, jak vložit některá pole pomocí těchto možností.
Vkládání polí do dokumentu pomocí nástroje DokumentBuilder
In Aspose.Words vá InsertField metoda se používá k vložení nových polí do dokumentu. První parametr přijímá úplný kód pole, který má být vložen. Druhý parametr je volitelný a umožňuje ručně nastavit výsledek pole. Pokud toto není dodáno, pak se pole automaticky aktualizuje. Pro vložení pole s prázdnou hodnotou pole můžete přejít do tohoto parametru null nebo prázdný. Pokud si nejste jisti konkrétní syntaxi kódu pole, vytvořit pole v Microsoft Word Nejprve přepněte na kód pole.
Následující příklad kódu ukazuje, jak vložit pole sloučení do dokumentu pomocí DocumentBuilder:
Stejná technika se používá pro vkládání polí do jiných polí.
Následující příklad kódu ukazuje, jak vložit pole vnořená do jiného pole pomocí DocumentBuilder:
Upřesnit umístění na úrovni pole
Identifikátor jazyka je standardní mezinárodní numerická zkratka pro jazyk v zemi nebo zeměpisné oblasti. S Aspose.Words, můžete zadat Locale na úrovni pole pomocí LocaleId majetek, který dostane nebo nastaví místní ID pole.
Následující příklad kódu ukazuje, jak použít tuto volbu:
Vložit nepodepsané/Vyprázdněné pole
Pokud chcete vložit netypovaná/prázdná pole ({}) stejně jako Microsoft Word umožňuje, můžete použít InsertField metoda s FieldType.FieldNone parametr. Chcete-li vložit pole do dokumentu Word, můžete stisknout kombinaci klávesy Ctrl + F9.
Následující příklad kódu ukazuje, jak vložit prázdné pole do dokumentu:
Vložit COMPARE
Pole
The COMPARE
pole porovnává dvě hodnoty a vrací číselnou hodnotu 1, pokud je srovnání true nebo 0, pokud srovnání je false.
Následující příklad kódu ukazuje, jak přidat COMPARE
Pole používající dokumentStavitel:
Vložit IF
Pole
The IF
pole lze použít k vyhodnocení argumentů podmíněně.
Následující příklad kódu ukazuje, jak přidat IF
Pole používající dokumentStavitel:
Vkládání polí do dokumentu pomocí stavění pole
Alternativní způsob vkládání polí do Aspose.Words je FieldBuilder třída. Poskytuje plynulé rozhraní pro určení hodnot spínačů a argumentů jako text, uzly nebo dokonce vnořená pole.
Následující příklad kódu ukazuje, jak vložit pole do dokumentu pomocí FieldBuilder:
Vkládání polí pomocí DOM
Můžete také vložit různé typy polí pomocí Aspose.Words Document Object Model (DOM). V této části se podíváme na několik příkladů.
Vkládání sloučení Pole do dokumentu pomocí DOM
MERGEFIELD
pole v dokumentu Word může být reprezentováno FieldMergeField třída. Můžete použít FieldMergeField třída provádět tyto operace:
- uveďte název pole sloučení
- zadat formátování pole sloučení
- zadat text mezi oddělovačem pole a koncem pole sloučení
- zadat text, který má být vložen za pole sloučení, není-li pole prázdné
- zadat text, který má být vložen před pole sloučení, není-li pole prázdné
Následující příklad kódu ukazuje, jak přidat MERGE
použití pole DOM k odstavci v dokumentu:
Vkládání Mail Merge ADDRESSBLOCK
pole do dokumentu pomocí DOM
The ADDRESSBLOCK
a Mail Merge blok adres v dokumentu Word. ADDRESSBLOCK
pole v dokumentu Word může být reprezentováno FieldAddressBlock třída. Můžete použít FieldAddressBlock třída provádět tyto operace:
- uveďte, zda má být název země/regionu zařazen do pole
- uveďte, zda má být adresa zformátována podle země/regionu příjemce podle POST*CODE (Universal Post Union 2006)
- uveďte vyloučenou zemi/název oblasti
- zadat název a formát adresy
- zadat jazykové ID používané pro formátování adresy
Následující příklad kódu ukazuje, jak přidat Mail Merge ADDRESSBLOCK
Použití pole DOM k odstavci v dokumentu:
Vkládání ADVANCE
pole do dokumentu bez použití nástroje DocumentBuilder
The ADVANCE
pole se používá k vyrovnání následujícího textu v řádku vlevo, vpravo, nahoře nebo dolů. ADVANCE
pole v dokumentu Word může být reprezentováno FieldAdvance třída. Můžete použít FieldAdvance třída provádět tyto operace:
- uveďte počet bodů, o které by text, který následuje po poli, měl být přesunut vertikálně z horního okraje stránky
- uveďte počet bodů, kterými se text, který následuje po poli, přesune vodorovně z levého okraje sloupce, rámu nebo textového pole
- uveďte počet bodů, kterými by měl být text, který následuje po poli, přesunut doleva, doprava, nahoru nebo dolů
Následující příklad kódu ukazuje, jak přidat ADVANCE
Použití pole DOM k odstavci v dokumentu:
Vkládání ASK
pole do dokumentu bez použití nástroje DocumentBuilder
The ASK
pole se používá k tomu, aby uživatel pro text přiřadil do záložky v dokumentu Word. ASK
pole v dokumentu Word může být reprezentováno FieldAsk třída. Můžete použít FieldAsk třída provádět tyto operace:
- uveďte název záložky
- zadat výchozí uživatelskou odpověď (počáteční hodnota obsažená v rychlém okně)
- určí, zda má být odpověď uživatele obdržena jednou za Mail Merge provoz
- zadat rychlý text (název rychlého okna)
Následující příklad kódu ukazuje, jak přidat ASK
Použití pole DOM k odstavci v dokumentu:
Vkládání AUTHOR
pole do dokumentu bez použití nástroje DocumentBuilder
The AUTHOR
pole se používá k upřesnění jména autora dokumentu Document
vlastnosti. AUTHOR
pole v dokumentu Word může být reprezentováno FieldAuthor třída. Můžete použít FieldAuthor třída provádět tyto operace:
- uveďte jméno autora dokumentu
Následující příklad kódu ukazuje, jak přidat AUTHOR
Použití pole DOM k odstavci v dokumentu:
Vkládání INCLUDETEXT
pole do dokumentu bez použití nástroje DocumentBuilder
The INCLUDETEXT
pole vkládá text a grafiku obsažené v dokumentu uvedeném v kódu pole. Celý dokument nebo část dokumentu uvedeného v záložce můžete vložit. Toto pole v dokumentu Word je reprezentováno VORGETEXT. Můžete použít FieldIncludeText třída provádět tyto operace:
- uveďte název záložky přiloženého dokumentu
- uveďte umístění dokladu
Následující příklad kódu ukazuje, jak přidat INCLUDETEXT
použití pole DOM k odstavci v dokumentu:
Vkládání TOA
pole do dokumentu bez použití nástroje DocumentBuilder
The TOA
(Tabulka orgánů) pole staví a vkládá tabulku úřadů. The TOA
pole shromažďuje položky označené TA
(Tabulka záznamů orgánů) pole. Microsoft Kancelářské slovo vloží TOA
field when you click Insert Table of Authorities in the Tabulka orgánů skupina References Účet. Když vidíte TOA
pole ve vašem dokumentu, syntaxe vypadá takto:
{ TOA
[Switches ] }
Následující příklad kódu ukazuje, jak přidat TOA
použití pole DOM na odstavec v dokumentu.