Spolupráce se sekcemi
Někdy chcete dokument, který nemá stejný formátování na všech stránkách. Například budete muset 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 pomocí sekcí.
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 formátovat změny, 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 je 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í část jako NewColumn, NewPage, EvenPage a OddPage.
Správa sekce
Vzhledem k tomu, sekce je normální kompozitní uzel, celá manipulace s uzly API lze použít 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 zlomovou část
Aspose.Words umožňuje vložit sekci 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řestávky v sekci. 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 část
Pokud chcete přesunout část z jedné pozice do druhé 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 dostat do první sekce a iterovat 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 tvůrčí uspořádání pro různé sekce dokumentů. Chcete-li zadat typ sítě aktuální sekce, můžete zvolit režim rozložení 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
Při přidání nové sekce do dokumentu nebude žádné tělo ani odstavec, který můžete upravit. 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 sekce
Aspose.Words umožňuje duplikovat sekci vytvořením celé kopie ní pomocí Clone metoda.
Následující příklad kódu ukazuje, jak naklonovat první oddíl 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 sekce a zápatí
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 “Odlišnou první stránku” a “Odlišné stránky a dokonce i jiné stránky” nastavení sekce “A” pokud jsou zakázány, pak jsou ignorovány vlastní tituly 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 zápatí 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 uspořádání 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 upravit vlastnosti stránky ve všech sekcích: