Spolupráce se sekcemi
Někdy chcete dokument, který nemá stejný formát na všech stránkách. Například můžete potřebovat upravit formáty čísel stránek, mít jinou velikost stránky a orientaci nebo mít první stránku dokumentu jako titulní stránku bez číslování. Toho můžete dosáhnout sekcemi.
Sekce jsou rovné uzly, které ovládají hlavičky a zápatí, orientaci, sloupce, okraje, formátování čísel stránek a další.
Aspose.Words umožňuje spravovat sekce, rozdělit dokument do sekcí a provádět změny formátování, které se vztahují pouze na konkrétní oddíl. Aspose.Words ukládá informace o formátování sekcí, jako jsou hlavičky a zápatí, nastavení stránek a nastavení sloupců v sekci přestávky.
Tento článek vysvětluje, jak pracovat s úseky a přestávkami.
Co je sekce a sekce přestávka
Sekce dokumentů jsou zastoupeny Section a SectionCollection třídy. Sekce objekty jsou okamžité děti Document Uzel a lze k němu přistupovat přes Sections majetek. Můžete spravovat tyto uzly pomocí některých metod, jako jsou Remove, Add, IndexOf, a další.
Přestávka sekce je volba, která rozděluje stránky dokumentů do sekcí s přizpůsobitelným uspořádáním.
Typy přerušení úseku
Aspose.Words umožňuje rozdělit a formátovat dokumenty pomocí různých částí přestávky BreakType číslice:
- Sekce BreakContinous
- SectionBreakNewColumn
- SekceBreakNewPage
- SekceBreakEvenPage
- SekceBreakOddPage
Můžete také použít SectionStart počet pro výběr typu přestávky, který platí pouze pro první oddíl jako NewColumn, NewPage, EvenPage a OddPage.
Správa sekce
Vzhledem k tomu, sekce je normální kompozitní uzel, celá manipulace s uzly API mohou být použity pro manipulaci s úseky: pro přidání, odstranění a jiné operace na sekcích. Více o uzlech si můžete přečíst v článku Aspose.Words Document Object Model (DOM).
Na druhou stranu, můžete také použít DocumentBuilder API pracovat s sekcemi. V tomto článku se zaměříme na tento konkrétní způsob práce s oddíly.
Vložit nebo odstranit zlom v části
Aspose.Words umožňuje vložit část vloupání do textu pomocí InsertBreak metoda.
Následující příklad kódu ukazuje, jak vložit oddíl vloupání do dokumentu:
Použijte Remove způsob odstranění přerušení sekce. Pokud nepotřebujete odstranit určitou část přestávky a místo toho smazat obsah této sekce, můžete použít ClearContent metoda.
Následující příklad kódu ukazuje, jak odstranit části přestávky:
Přesunout oddíl
Pokud chcete přesunout část z jedné pozice na druhou ve vašem dokumentu, musíte získat index této sekce. Aspose.Words umožňuje získat pozici sekce z SectionCollection. Můžete použít Sections vlastnost pro získání všech částí ve vašem dokumentu. Ale pokud chcete získat pouze první část, můžete použít FirstSection majetek.
Následující příklad kódu ukazuje, jak se dostanete do první sekce a iterujete prostřednictvím dětí kompozitního uzlu:
Upřesnit uspořádání oddílu
Někdy chcete, aby váš dokument vypadal lépe tím, že kreativní uspořádání pro různé sekce dokumentů. Pokud chcete zadat typ sítě aktuální sekce, můžete si zvolit režim uspořádání sekce pomocí SectionLayoutMode číslice:
- Výchozí
- Grid
- LineGrid
- SnapToChars
Následující příklad kódu ukazuje, jak omezit počet řádků, které každá stránka může mít:
Upravit část
Když přidáte novou sekci do dokumentu, nebude žádné tělo nebo odstavec, který můžete editovat. Aspose.Words umožňuje zaručit, že část obsahuje tělo s alespoň jedním odstavcem pomocí EnsureMinimum metoda
Následující příklad kódu ukazuje, jak připravit nový uzel sekce pomocí EnsureMinimum:
Přidávat nebo prepend obsah
Pokud chcete na začátku/konci sekce nakreslit nějaký tvar nebo přidat text nebo obrázek, můžete použít AppendContent a PrependContent metody Section třída.
Následující příklad kódu ukazuje, jak přidat obsah stávající sekce:
Klonovat oddíl
Aspose.Words umožňuje duplikovat sekci vytvořením celé kopie ní pomocí deepClone metoda.
Následující příklad kódu ukazuje, jak naklonovat první část ve vašem dokumentu:
Kopírovat oddíly mezi dokumenty
V některých případech můžete mít velké dokumenty s mnoha oddíly a chcete zkopírovat obsah části z jednoho dokumentu do druhého.
Aspose.Words umožňuje kopírovat sekce mezi dokumenty pomocí ImportNode metoda.
Následující příklad kódu ukazuje, jak kopírovat oddíly mezi dokumenty:
Práce s hlavičkou a zápatí sekce
Základní pravidla pro zobrazení hlavičky nebo zápatí pro každou část jsou jednoduchá:
- Pokud část nemá vlastní hlavičky/nohy určitého typu, pak je převzata z předchozí části.
- Typ hlavičky/noha zobrazená na stránce je řízen “různou první stránkou” a “různou Odd & Even pages” nastavení sekce “NAME OF TRANSLATORS” pokud jsou zakázány, pak jsou ignorovány vlastní titulky sekce.
Následující příklad kódu ukazuje, jak vytvořit 2 sekce s různými hlavičkami:
Pokud chcete odstranit text hlaviček a zápatí bez odstranění HeaderFooter objekty ve vašem dokumentu, můžete použít ClearHeadersFooters metoda. Kromě toho můžete použít DeleteHeaderFooterShapes způsob odstranění všech tvarů z hlaviček a zápatí ve vašem dokumentu.
Následující příklad kódu ukazuje, jak odstranit obsah všech hlaviček a zápatí v sekci:
Následující příklad kódu, jak odstranit všechny tvary ze všech patek hlaviček v sekci:
Přizpůsobit vlastnosti stránky v sekci
Před tiskem stránky nebo dokumentu si možná budete chtít přizpůsobit a upravit velikost a rozložení jedné stránky nebo celého dokumentu. S nastavením stránky můžete změnit nastavení stránek dokumentů, jako jsou okraje, orientace a velikost pro tisk různých prvních stránek nebo lichých stránek.
Aspose.Words umožňuje přizpůsobit vlastnosti stránky a sekce pomocí PageSetup třída.
Následující příklad kódu ukazuje, jak nastavit takové vlastnosti jako velikost stránky a orientaci pro aktuální sekci:
Následující příklad kódu ukazuje, jak změnit vlastnosti stránky ve všech sekcích: