Práce s obsahem

Často budete pracovat s dokumenty obsahujícími obsah (TOC). Použití Aspose.Words můžete vložit vlastní tabulku obsahu nebo kompletně obnovit stávající tabulku obsahu v dokumentu pomocí několika řádků kódu.

Tento článek nastiňuje, jak pracovat s obsahem pole a ukazuje:

  • Jak vložit nový TOC.
  • Aktualizovat nové nebo stávající TOC v dokumentu.
  • Specifikujte přepínače pro ovládání formátování a celkové struktury TOC.
  • Jak upravit styly a vzhled obsahu.
  • Jak odstranit celý TOC pole spolu se všemi záznamy z dokumentu.

Vložit obsah programově

Můžete vložit TOC (obsah) pole do dokumentu na aktuální pozici voláním InsertTableOfContents metoda.

Tabulka obsahu v dokumentu Word lze vytvořit několika způsoby a formátovat pomocí různých možností. Pole přepíná, které přecházíte na metodu ovládání způsobu, jakým je tabulka postavena a zobrazena ve vašem dokumentu.

Výchozí spínače, které jsou použity v TOC vloženo do Microsoft Word jsou “To je ono. Popisy těchto přepínačů a seznam podporovaných přepínačů naleznete později v článku. Můžete buď použít tento návod k získání správných přepínačů nebo pokud již máte dokument obsahující podobné TOC že chcete zobrazit kódy polí (ALT+F9) a zkopírovat přepínače přímo z pole.

Následující příklad kódu ukazuje, jak vložit pole Obsah:

Následující příklad kódu ukazuje, jak vložit tabulku obsahu (TOC) do dokumentu s použitím stylů záhlaví jako položky:

Kód ukazuje, že nová tabulka obsahu je vložena do prázdného dokumentu. The DocumentBuilder třída se pak používá k vložení určitého obsahu vzorku formátování s příslušnými styly záhlaví, které se používají k označení obsahu, který má být zařazen do TOC. Další linie pak zalidnit TOC aktualizací polí a rozložení stránky dokumentu.

insert-table-of-contents-field-aspose-words-java

Aktualizovat Obsah

Aspose.Words umožňuje kompletně aktualizovat TOC jen pár řádků kódu. To se dá udělat, aby se nově vložené populace TOC nebo aktualizovat existující TOC po provedení změn dokumentu.

Pro aktualizaci musí být použity tyto dvě metody: TOC Pole v dokumentu:

  1. Document.updateFields()
  2. Document.updatePageLayout()

Upozorňujeme, že tyto dvě metody aktualizace musí být v tomto pořadí volány. V případě obrácení tabulky obsahu bude obsazena, ale nezobrazí se žádná čísla stránek. Lze aktualizovat libovolný počet různých TOC. Tyto metody automaticky aktualizují všechny TOC nalezené v dokumentu.

Následující příklad kódu ukazuje, jak kompletně obnovit TOC pole v dokumentu zavoláním aktualizací polí:

První hovor Document.updateFields() bude stavět <span notrans="<span notrans=” TOC"="">, všechny textové záznamy jsou obsazeny a TOC Vypadá to skoro kompletní. Jediné, co chybí, jsou čísla stránek, které jsou nyní zobrazeny s??

Druhý hovor Document.updatePageLayout() vytvoří uspořádání dokumentu v paměti. To je třeba udělat pro shromažďování čísel stránek záznamů. Správná čísla stránky vypočtená z tohoto hovoru se pak vloží do TOC.

Použít přepínače k ovládání obsahu Chování

Stejně jako u jiných polí, TOC pole může přijmout přepínače definované v kódu pole, které řídí, jak je obsah postaven. Některé spínače se používají k řízení, které položky jsou zahrnuty, a na jaké úrovni, zatímco ostatní jsou používány pro kontrolu vzhledu TOC. Přepínače lze kombinovat dohromady, aby se vytvořila složitá tabulka obsahu.

ccontrol-table-of-contents-field-aspose-words-java

Ve výchozím nastavení jsou tyto přepínače zahrnuty při vkládání výchozí hodnoty TOC v dokumentu. A TOC bez výhybek bude obsahovat obsah ze vestavěných stylů (jako když je nastaven \O switch).

Dostupné TOC přepínače, které jsou podporovány Aspose.Words jsou uvedeny níže a jejich použití je podrobně popsáno. Mohou být rozděleny do samostatných sekcí podle svého typu. Přepínače v první části definují, jaký obsah má obsahovat TOC a přepínače ve druhém úseku ovládají vzhled TOC.

Pokud zde není uveden spínač, není v současné době podporován. Všechny přepínače budou podporovány v budoucích verzích. Přidáváme další podporu každému vydání.

Spínače vstupních značek

Přepnout Popis zboží
Heading Styles
*(\O Switch) *

Tento spínač definuje, že TOC by měly být postaveny mimo vestavěný směrový styl. In Microsoft Word, jsou definovány v čísle 1 9. Aspose.Words tyto styly jsou reprezentovány odpovídajícím stylemIdentifier počet. Tato číslice představuje lokální nezávislý identifikátor stylu, například: StyleIdentifier.Heading1 představuje styl záhlaví 1. Díky tomu lze formátování a vlastnosti stylu získat ze sbírky stylu dokumentu. Odpovídající styl třídy lze získat z Document.Styles sběr pomocí indexované vlastnosti typu StyleIdentifier.

![style-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-3.png)



Jakýkoli obsah upravený těmito styly je zahrnut v obsahu. Úroveň záhlaví bude definovat odpovídající hierarchickou úroveň vstupu v TOC. Například odstavec s číslem 1 bude považován za první úroveň v `TOC` Zatímco odstavec s číslem 2 bude považován za další úroveň v hierarchii a tak dále.

| | **Outline Levels**
*(\U switch) *
|

Každý odstavec může definovat úroveň obrysu podle možností odstavce.

![modify-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-4.png)



Toto nastavení určuje, která úroveň by měla být v hierarchii dokumentu upravena. Jedná se o běžně používanou praxi používanou pro snadnou strukturu uspořádání dokumentu. Tuto hierarchii lze prohlížet přechodem na Outline View Microsoft Word. Podobně jako ve stylu záhlaví, může být kromě úrovně "Body Text" 1 a 9 obrysových úrovní. Východiska úrovně 1 a 9 se objeví v `TOC` v odpovídající úrovni hierarchie
Jakýkoliv obsah s obrysovou úrovní buď stanovenou v odstavci, nebo přímo na samotném odstavci je zahrnut do TOC. In Aspose.Words úroveň obrysu představuje `ParagraphFormat.OutlineLevel` vlastnictví uzel odstavce. Nastavovací úroveň odstínu představuje stejným způsobem `Style.ParagraphFormat` majetek.

| | **Custom Styles**
*(\ T switch) *
|

Tento spínač umožní použití vlastních stylů při shromažďování položek v TOC. Často se používá ve spojení s \O přepínačem, aby zahrnoval vlastní styly spolu s vestavěným kurzovým stylem v TOC.
Parametry přepínače by měly být uvedeny ve znacích řeči. Mnoho vlastních stylů může být zahrnuto, pro každý styl, název by měl být uveden následuje čárka následuje úroveň, že styl by se měl objevit v `TOC` a. Další styly jsou také odděleny čárkou.
Například

{ TOC \o "1-3" \t "CustomHeading1, 1,   CustomHeading2, 2"}

bude používat obsah ve stylu CustomHeading1 jako obsah úrovně 1 v `TOC` a CustomHeading2 jako úroveň 2.

| | Použít TC pole
*(\F a \L přepínače) *
|

Ve starších verzích Microsoft Word, Jediný způsob, jak postavit `TOC` bylo použití TC polí. Tato pole jsou vložena do dokumentu, i když jsou zobrazeny kódy polí. Zahrnuje text, který by měl být zobrazen v záznamu a `TOC` je z nich postaven. Tato funkce se nyní nepoužívá velmi často, ale může být stále užitečné v některých případech zahrnout položky do `TOC` které nejsou označeny jako viditelné v dokumentu.
Při vložení se tato pole objeví skrytá i při zobrazení kódů polí. Nemůžou být vidět, aniž by ukázali skrytý obsah. Pro zobrazení těchto polí je třeba zvolit formátování odstavce.

![setup-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-5.png)

Tato pole mohou být vložena do dokumentu v jakékoli pozici, jako je jakékoli jiné pole a jsou zastoupena `FieldType.FieldTOCEntry` výčtu.
\F přepínač v `TOC` se používá k upřesnění, že TC pole by měla být použita jako položky. Přepínač sám o sobě bez jakéhokoliv dalšího identifikátoru znamená, že bude zahrnuto jakékoliv TC pole v dokumentu. Jakýkoli další parametr, často jedno písmeno, určí, že do TOC budou zahrnuta pouze TC pole, která mají odpovídající \f switch. Například *

{ TOC \f t }

budou zahrnovat pouze TC pole jako např.

{ TC \f t }

The `TOC` pole má také související spínač, spínač

![table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-6.png)



The `TC` Pole sama o sobě mohou mít {several, `multiple`, a few, `many`, numerous} přepínače nastaveny. Jedná se o:

- Vysvětlováno výše. *

Určuje, na jaké úrovni `TOC` Tohle TC pole se objeví. A `TOC` který používá stejný spínač, bude obsahovat toto TC pole pouze tehdy, pokud se nachází ve stanoveném rozsahu.

- Ne. Číslování této stránky `TOC` záznam není zobrazen. Vzorový kód, jak vložit TC pole, naleznete v následující sekci.

|

Spínače týkající se vzhledu

Přepnout Popis zboží
Omit Page Numbers
*(\N Switch) *

Tento spínač se používá ke skrytí čísel stránek pro určité úrovně TOC. Například, můžete definovat

{TOC \o "1-4" \n "3-4" }

a čísla stránek na položky úrovně 3 a čtyři budou skryty spolu s body vůdce (pokud existují). Pro upřesnění pouze jedné úrovně by měl být stále použit rozsah, například ~1-1 ~1 - ~ bude vyloučeno číslo stránky pouze pro první úroveň.
Dodání žádné úrovně rozsah bude vynechat čísla stránek pro všechny úrovně v TOC. To je užitečné nastavit při exportu dokumentu do HTML nebo podobného formátu. To je proto, že formáty založené na HTML nemají žádnou koncepci stránky, a proto donnot potřebují jakékoliv číslování stránky.

![table-of-contents-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-7.png)

| | Vložit jako hypertextové odkazy
*(\H Switch) * |

Tento spínač udává, že `TOC` položky se vkládají jako hypertextové odkazy. Při pohledu na dokument Microsoft Word tyto položky se stále objeví jako normální text uvnitř `TOC` ale jsou hyperlinkované a lze je tedy použít k navigaci do polohy původního záznamu v dokumentu pomocí *Ctrl + Left Click* v Microsoft Word. Pokud je tento spínač součástí, pak jsou tyto odkazy zachovány i v jiných formátech. Například ve formátech založených na HTML, včetně EPUB a interpretovaných formátů jako PDF a XPS, budou exportovány jako pracovní odkazy.
Bez tohoto přepínače `TOC` ve všech těchto výstupech bude exportován jako prostý text a nebude demonstrovat toto chování. Pokud je dokument otevřen v MS Word, text záznamů nebude také možné kliknout tímto způsobem, ale čísla stránek mohou být stále použita k navigaci na původní záznam.

![tree-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-8.png)

| | **Set Separator Character**
*(\P Switch) *
|

Tento přepínač umožňuje snadno změnit obsah oddělení názvu záznamu a číslování stránek v TOC. Oddělovač, který má být použit, by měl být za tímto přepínačem uveden a uveden ve známkách řeči.
Na rozdíl od toho, co je zdokumentováno v dokumentaci úřadu, může být použit pouze jeden znak namísto pěti. To platí jak pro MS Word a Aspose.Words.
Použití tohoto přepínače se nedoporučuje, protože neumožňuje mnoho kontroly nad tím, co použil k oddělení položek a čísel stránek v TOC. Místo toho se doporučuje upravit vhodné `TOC` styl, jako je `StyleIdentifier.TOC1` a odtud editovat styl vůdce s přístupem ke konkrétním členům písma atd. Další podrobnosti o tom, jak to udělat, najdeme později v článku.

![list-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-9.png)

| | **Preserve Tab Entries**
*(\W Switch) * |

Pomocí tohoto přepínače bude uvedeno, že všechny položky, které mají znak záložky, například nadpis, který má kartu na konci řádku, budou zachovány jako správný znak karty při zalidnění TOC. To znamená, že funkce znaku karty bude přítomna v `TOC` a lze jej použít pro formátování záznamu. Například některé položky mohou použít záložky a znaky záložky k rovnoměrnému vyškrtnutí textu. Tak dlouho jako odpovídající `TOC` úroveň definuje ekvivalentní kartu zastaví pak generované `TOC` položky se objeví s podobným odstupem.

Ve stejné situaci, pokud tento přepínač nebyl definován, pak by znaky záložky byly převedeny na bílý ekvivalent místa jako nefunkční záložky. Výstup by pak nevypadal podle očekávání.

![tab-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-10.png)

| | **Preserve New Line Entries**
*(\ X Switch) *
|

Podobně jako výše uvedený přepínač, tento spínač udává, že položky sahající přes více řádků (pomocí nových znaků, nikoli samostatných odstavců) budou zachovány tak, jak jsou ve generovaném TOC. Například nadpis, který se má šířit přes více řádků, může použít nový znak řádku (Ctrl + Enter nebo `ControlChar.LineBreak`) oddělit obsah přes různé řádky. S tímto přepínačem stanoveným, položka v `TOC` zachová tyto nové znaky, jak je uvedeno níže.

V této situaci, pokud přepínač není definován, pak nové znaky řádku jsou převedeny na jediný bílý prostor.

![tab-space-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-11.png)

|

Vložit pole TC

Nové TC pole můžete vložit do aktuální polohy DocumentBuilder voláním DocumentBuilder.InsertField způsob a uvedení názvu pole jako

Následující příklad kódu ukazuje, jak vložit TC pole do dokumentu pomocí DocumentBuilder.

Často je zvláštní text určen pro TOC a je označena TC pole. Snadný způsob, jak to udělat v MS Word je zvýraznit text a stisknout ALT+SHIFT+O. To automaticky vytvoří a TC pole pomocí vybraného textu. Stejnou techniku lze provést pomocí kódu. Níže uvedený kód najde text odpovídající vstupu a vloží TC pole ve stejné pozici jako text. Kód je založen na stejné technice používané v článku. Následující příklad kódu ukazuje, jak najít a vložit TC pole v textu v dokumentu.

Upravit obsah

Změnit formátování stylů

Formátování záznamů v TOC nepoužívá původní styly označených položek, místo toho je každá úroveň formátována za použití rovnocenného TOC Styl. Například první úroveň TOC je formátován s TOC1 styl, druhá úroveň formátovaná s TOC2 styl a tak dále. To znamená, že změnit vzhled TOC Tyto styly musí být upraveny. In Aspose.Words Tyto styly jsou reprezentovány locale-nezávislý StyleIdentifier.TOC1 až do StyleIdentifier.TOC9 a lze získat z Document.Styles sběr pomocí těchto identifikátorů.

Jakmile bude příslušný styl dokumentu vybrán, formátování tohoto stylu lze upravit. Veškeré změny těchto stylů se automaticky projeví v TOC v dokumentu.

Následující příklad kódu mění vlastnost formátování použitou v první úrovni TOC Styl.

Je rovněž užitečné poznamenat, že jakékoli přímé formátování odstavce (definované v samotném odstavci a nikoli ve stylu), které mají být zahrnuty do TOC bude zkopírován v záznamu v TOC. Například, pokud se používá styl záhlaví 1 k označení obsahu TOC a tento styl má odvážný formátování, zatímco odstavec má také kurzívu formátování přímo aplikovat na něj. Výsledek TOC vstup nebude troufalý, protože je součástí formátování stylu, ale bude italický, protože je přímo formátován na odstavci.

Můžete také ovládat formátování oddělovačů použitých mezi jednotlivými položkami a číslem stránky. Ve výchozím nastavení se jedná o tečkovanou čárku, která je rozložena do číslování stránky pomocí znakové karty a pravé záložky zastavit seřazené v blízkosti správného okraje.

Použití Style třída získaná pro konkrétní TOC úroveň, kterou chcete upravit, můžete také upravit, jak se objeví v dokumentu.

Abych změnil, jak to vypadá, Style.ParagraphFormat musí být vyzván, aby získal odstavec formátování pro styl. Z toho lze záložka zastavit voláním ParagraphFormat.TabStops a odpovídajícím zastavením karty. Pomocí stejné techniky lze kartu úplně přesunout nebo úplně odstranit.

Následující příklad kódu ukazuje, jak upravit pozici pravé záložky zastavit v TOC související odstavce.

Odstranit obsah dokumentu

Obsah lze z dokumentu odstranit odstraněním všech uzlů nalezených mezi FieldStart a FieldEnd uzel TOC pole.

Níže uvedený kód to dokazuje. Odstranění TOC pole je jednodušší než normální pole, protože nesledujeme hnízdiště. Místo toho zkontrolujeme FieldEnd Uzel typu FieldType.FieldTOC Což znamená, že jsme narazili na konec současného TOC. Tato technika může být použita v tomto případě bez obav o vnořená pole, protože můžeme předpokládat, že žádný řádně vytvořený dokument nebude mít plně hnízdit TOC pole uvnitř jiného TOC pole.

Zaprvé: FieldStart uzly každého TOC jsou shromažďovány a skladovány. Zadané TOC je pak vyjmenován, takže všechny uzly v poli jsou navštíveny a uloženy. Uzely jsou pak z dokumentu odstraněny. Následující příklad kódu ukazuje, jak odstranit zadané TOC z dokumentu.

Obsah výpisu

Pokud chcete z jakéhokoli dokumentu Word extrahovat tabulku obsahu, můžete použít následující vzorek kódu.