Vložit pole

Existuje několik různých způsobů, jak vložit pole do dokumentu:

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: