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 Model Objektu Dokumentu (DOM)

V tomto článku se podíváme na každou cestu podrobněji a analyzujeme, jak vložit určitá pole pomocí těchto možností.

Vkládání polí do dokumentu pomocí DocumentBuilder

V Aspose.Words se metoda InsertField používá k vložení nových polí do dokumentu. První parametr přijímá úplný kód pole pole, které má být vloženo. Druhý parametr je volitelný a umožňuje ruční nastavení výsledku pole pole. Pokud toto není dodáno, pole se automaticky aktualizuje. K tomuto parametru můžete předat null nebo empty a vložit pole s prázdnou hodnotou pole. Pokud si nejste jisti syntaxí konkrétního kódu pole, vytvořte pole nejprve v Microsoft Word a přepnutím zobrazte jeho kód pole.

Pokud má váš kód pole parametr obsahující mezeru, musí být uzavřen do řečových značek. Jinak pole v obou Microsoft Word a Aspose.Words nemusí fungovat podle očekávání, protože parametr je oběma považován za zkrácený

Následující příklad kódu ukazuje, jak vložit slučovací pole do dokumentu pomocí DocumentBuilder:

Stejná technika se používá k vkládání polí vnořených do jiných polí.

Následující příklad kódu ukazuje, jak vložit pole vnořená do jiného pole pomocí DocumentBuilder:

Zadejte národní prostředí na úrovni pole

Identifikátor jazyka je standardní mezinárodní číselná zkratka pro jazyk v zemi nebo zeměpisné oblasti. Pomocí Aspose.Words můžete určit národní prostředí na úrovni pole pomocí vlastnosti LocaleId, která získá nebo nastaví národní prostředí pole ID.

Následující příklad kódu ukazuje, jak tuto možnost použít:

Vložit Netypované / Prázdné Pole

Pokud chcete vložit netypovaná / prázdná pole ({}) stejně jako Microsoft Word umožňuje, můžete použít metodu InsertField s parametrem FieldType.FieldNone. Chcete-li vložit pole do dokumentu Word, můžete stisknout kombinaci kláves “Ctrl + F9”.

Následující příklad kódu ukazuje, jak vložit prázdné pole do dokumentu:

Vkládání polí do dokumentu pomocí FieldBuilder

Alternativní způsob vložení polí do Aspose.Words je třída FieldBuilder. Poskytuje plynulé rozhraní pro určení přepínačů polí a hodnot 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 Model Objektu Dokumentu (DOM). V této části se podíváme na několik příkladů.

Vložení slučovacího pole do dokumentu pomocí DOM

Pole MERGEFIELD v dokumentu Word může být reprezentováno třídou FieldMergeField. Třídu FieldMergeField můžete použít k provedení následujících operací:

• zadejte název pole sloučení
• určete formátování pole sloučení
• určete text, který je mezi oddělovačem polí a koncem pole slučovacího pole
• pokud pole není prázdné, zadejte text, který se má vložit za pole sloučení
• pokud pole není prázdné, zadejte text, který se má vložit Před pole sloučení

Další podrobnosti viz FieldMergeField třída API.

Následující příklad kódu ukazuje, jak přidat pole MERGE pomocí DOM do odstavce v dokumentu:

Ukázkový soubor tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Vložení Mail Merge pole bloku adresy do dokumentu pomocí DOM

Pole ADDRESSBLOCK se používá k vložení bloku adresy Mail Merge do dokumentu Word. ADDRESSBLOCK pole v Word dokumentu může být reprezentováno třídou FieldAddressBlock. Třídu FieldAddressBlock můžete použít k provedení následujících operací:

• určete, zda chcete do pole Zahrnout název země/oblasti
• určete, zda se má Adresa formátovat podle země / oblasti příjemce podle definice POST*CODE (Světová poštovní unie 2006)
• zadejte název vyloučené země / oblasti
• zadejte název a formát adresy
• zadejte jazyk ID použitý k formátování adresy

Další podrobnosti viz FieldAddressBlock třída API.

Následující příklad kódu ukazuje, jak přidat pole Mail Merge ADDRESSBLOCK pomocí DOM do odstavce v dokumentu:

Ukázkový soubor tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Vložení pole předem do dokumentu bez použití DocumentBuilder

Pole ADVANCE se používá k vyrovnání následného textu v řádku doleva, doprava, nahoru nebo dolů. Pole ADVANCE v dokumentu Word může být reprezentováno třídou FieldAdvance. Třídu FieldAdvance můžete použít k provedení následujících operací:

• určete počet bodů, o které by měl být text, který následuje po poli, přesunut svisle od horního okraje stránky
• určete počet bodů, o které má být text, který následuje po poli, přesunut vodorovně z levého okraje sloupce, rámečku nebo textového pole
• určete počet bodů, o které by měl být text, který následuje po poli, přesunut doleva, doprava, nahoru nebo dolů

Další podrobnosti viz FieldAdvance třída API.

Následující příklad kódu ukazuje, jak přidat pole ADVANCE pomocí DOM do odstavce v dokumentu:

Ukázkový soubor tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Vložení ASK pole do dokumentu bez použití DocumentBuilder

Pole ASK se používá k výzvě uživatele k přiřazení textu k záložce v dokumentu Word. ASK pole v Word dokumentu může být reprezentováno třídou FieldAsk. Třídu FieldAsk můžete použít k provedení následujících operací:

• zadejte název záložky
• zadejte výchozí odpověď uživatele (počáteční hodnota obsažená v okně výzvy)
• určete, zda má být odpověď uživatele přijata jednou za operaci Mail Merge
• zadejte text výzvy (název okna výzvy)

Další podrobnosti viz FieldAsk třída API.

Následující příklad kódu ukazuje, jak přidat pole ASK pomocí DOM do odstavce v dokumentu:

Ukázkový soubor tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Vložení AUTHOR pole do dokumentu bez použití DocumentBuilder

Pole AUTHOR se používá k určení jména autora dokumentu z vlastností Document. Pole AUTHOR v dokumentu Word může být reprezentováno třídou FieldAuthor. Třídu FieldAuthor můžete použít k provedení následujících operací:

• zadejte jméno autora dokumentu

Další podrobnosti viz FieldAuthor třída API.

Následující příklad kódu ukazuje, jak přidat pole AUTHOR pomocí DOM do odstavce v dokumentu:

Ukázkový soubor tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Vložení INCLUDETEXT pole do dokumentu bez použití DocumentBuilder

Pole INCLUDETEXT vloží text a grafiku obsaženou v dokumentu pojmenovaném v kódu pole. Můžete vložit celý dokument nebo část dokumentu, na kterou odkazuje Záložka. Toto pole v Word dokumentu je reprezentováno INCLUDETEXT. Třídu FieldIncludeText můžete použít k provedení následujících operací:

• zadejte název záložky přiloženého dokumentu
• určete umístění dokumentu

Další podrobnosti viz FieldIncludeText třída API.

Následující příklad kódu ukazuje, jak přidat pole INCLUDETEXT pomocí DOM do odstavce v dokumentu:

Vložení TOA pole do dokumentu bez použití DocumentBuilder

Pole TOA (Table of Authorities) vytvoří a vloží tabulku autorit. Pole TOA shromažďuje položky označené poli TA (Table of Authorities Entry). Microsoft Office Word vloží pole TOA, Když kliknete na Insert Table of Authorities ve skupině Table of Authorities na kartě References. Při zobrazení pole TOA v dokumentu vypadá syntaxe takto:

{ TOA [Switches ] }

Další podrobnosti viz FieldToa třída API.

Následující příklad kódu ukazuje, jak přidat pole TOA pomocí DOM do odstavce v dokumentu:

/