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á insert_field metoda se používá pro vložení nových polí do dokumentu. První parametr přijímá úplný kód pole, které má být vloženo. 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 Nejdřív 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:
Následující příklad kódu ukazuje, jak vložit pole sloučení s německým locale 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 Lokalita na úrovni pole. • locale_id nemovitost dostane nebo nastaví místní ID pole.
Následující příklad kódu ukazuje, jak této možnosti využít:
Vložit netypované/vyprázdněné pole
Pokud chcete vložit netypovaná/prázdná pole ({}) stejně jako Microsoft Word umožňuje, můžete použít insert_field metoda s FieldType.FIELD_NONE parametr. Chcete-li vložit pole do dokumentu Word, můžete stisknout kombinaci klávesy Ctrl + F9.1.2.
Následující příklad kódu ukazuje, jak do dokumentu vložit prázdné pole:
Vkládání polí do dokumentu pomocí polního stavitele
Alternativní způsob vložení polí do Aspose.Words je FieldBuilder třída. Nabízí 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:
- zadat název pole sloučení
- zadat formátování pole sloučení
- zadat text, který je 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 a Merge
Použití pole DOM k odstavci v dokumentu:
Vkládání Mail Merge ADDRESSBLOCK
pole do dokumentu pomocí DOM
• 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 definice POST*CODE (Universal Post Union 2006)
- uveďte vyloučenou zemi/region
- zadat název a formát adresy
- zadat jazyk 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 DokumentBuilder
• 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ů, kterými by měl být text, který následuje po poli, přesunut vertikálně z horního okraje stránky
- uveďte počet bodů, o které by text, který následuje po poli, měl být přesunut 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 na odstavec v dokumentu.
Vkládání ASK
pole do dokumentu bez použití nástroje DokumentBuilder
• 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 okně nápovědy)
- 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 DokumentBuilder
• 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 DokumentBuilder
• 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 DokumentBuilder
• TOA
(Tabulka úřadů) pole staví a vkládá tabulku úřadů. • 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 ] }
Můžete použít FieldToa třída k provádění operací s TOA
pole.
Následující příklad kódu ukazuje, jak přidat TOA
použití pole DOM k odstavci v dokumentu: