Přehled stavitelů dokumentů
DocumentBuilder je mocná třída, která spolupracuje s Document a umožňuje vytvářet dynamické dokumenty od nuly nebo přidávat nové prvky k existujícímu.
DocumentBuilder poskytuje metody pro vložení textu, checkboxů, ole objektů, odstavců, seznamů, tabulek, obrázků a dalších prvků obsahu. Umožňuje zadat písma, odstavec nebo oddíl formátování a provádět další operace.
Stavitel dokumentů nebo Aspose.Words DOM
DocumentBuilder doplňuje třídy a metody dostupné v Aspose.Words Document Object Model (DOM) zjednodušit nejčastější úkoly budování dokumentů. To znamená, že můžete vytvářet a upravovat obsah dokumentů jak prostřednictvím Aspose.Words DOM, který vyžaduje dobré pochopení struktury stromu a pomocí DocumentBuilder. • DocumentBuilder je “fasáda” pro komplex Document struktura, která vám umožní rychle a snadno vložit obsah a formátování.
Operace, které jsou možné s DocumentBuilder jsou také možné při použití tříd Aspose.Words DOM přímo. Nicméně při použití Aspose.Words DOM třídy přímo obvykle vyžadují více řádků kódu než použití DocumentBuilder.
Navigace dokumentů
Navigace dokumentů je založena na konceptu virtuálního kurzoru, se kterým se můžete přesunout na jiné místo v dokumentu pomocí různých DokumentBuilder.move_to_XX metody, jako jsou move_to_document_start a move_to_field. Tento virtuální kurzor označuje, kde bude text vložen při volání metod write, writeln, insert_break, a další. Viz následující článek “Navigace s kurzorem” se dozvíte více o virtuálním kurzoru.
Následující příklad kódu ukazuje, jak přejít na záložku:
Budova dokumentů a modifikace
Aspose.Words API poskytuje několik tříd, které jsou odpovědné za formátování různých prvků dokumentu. Každá z tříd zapouzdřuje vlastnosti formátování týkající se konkrétního prvku dokumentu, jako je text, odstavec, oddíl a další. Například: Font třída představuje vlastnosti formátování znaků, ParagraphFormat třída představuje vlastnosti formátování odstavce a tak dále. Předměty těchto tříd vrací odpovídající DocumentBuilder vlastnosti, které mají stejné názvy jako třídy. Proto se k nim můžete dostat a během sestavení dokumentu nastavit požadované formátování.
Můžete také vložit text, checkbox, ole objekt, obrázky, záložky, formulářová pole a další prvky dokumentu na pozici kurzoru pomocí Write nebo DokumentBuilder. vložit_XXX metody, například insert_field, insert_html, a podobné metody.
Podívejme se, jak vytvořit jednoduchý dokument pomocí DocumentBuilder.
Vytvořit dokument pomocí nástroje DokumentBuilder
Pro začátek musíte vytvořit DocumentBuilder a přidruž ji k Document objekt. Vytvoříte nový příklad DocumentBuilder tím, že volá jeho konstruktor a předat jej do Document objekt pro připojení ke staviteli.
Chcete-li vložit text, přejděte řetězec textu, který musíte vložit do dokumentu write metoda.
Následující příklad kódu ukazuje, jak vytvořit jednoduchý dokument pomocí stavitele dokumentů.
Upřesnit formát dokumentu
• font vlastnost definuje formátování textu. Tento objekt obsahuje různé atributy písma (název fontu, velikost písma, barva atd.). Některé důležité atributy písma jsou také reprezentovány DocumentBuilder vlastnosti, které vám umožní přístup přímo. Tohle jsou Font.bold, Font.italic, a Font.underline Booleovské vlastnosti.
Následující příklad kódu ukazuje, jak vložit formátovaný text DocumentBuilder:
- font určuje formát znaků, který bude aplikován na všechny texty vložené od aktuální polohy v dokumentu dále.
- paragraph_format určuje formátování odstavce pro aktuální a všechny odstavce, které mají být vloženy.
- page_setup určuje vlastnosti stránky a sekce pro aktuální sekci a celou sekci, která bude vložena.
- cell_format a row_format specifikovat vlastnosti formátování, které budou aplikovány na buňky tabulky a řádky od aktuální polohy v dokumentu dále.
V této situaci se “aktuálním” rozumí poloha, odstavec, oddíl, buňka nebo řádek, ve kterém je kurzor.