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á 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.