Přehled stavitelů dokumentů
DocumentBuilder je mocná třída, která se spojuje 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, zaškrtávacích boxů, 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 vytvořit a upravit obsah dokumentů jak prostřednictvím Aspose.Words DOM, který vyžaduje dobré pochopení struktury stromu, a pomocí DocumentBuilder. The 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. 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 DocumentBuilder.MoveToXXX metody, jako jsou MoveToDocumentStart a MoveToField. Tento virtuální kurzor označuje, kde bude text vložen při volání metod Write, Writeln, InsertBreak, 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:
Budování 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, zaškrtávačku, ole objekt, obrázky, záložky, formulářová pole a další prvky dokumentu na pozici kurzoru pomocí Write nebo DocumentBuilder.InsertXXX metody, jako jsou InsertField, InsertHtml, 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 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
The 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. Toto 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 použit pro všechny texty vložené od aktuální polohy v dokumentu dále.
- ParagraphFormat určuje formátování odstavce pro aktuální a všechny odstavce, které mají být vloženy.
- PageSetup určuje vlastnosti stránky a sekce pro aktuální sekci a celou část, která bude vložena.
- CellFormat a RowFormat specifikovat vlastnosti formátování, které budou použity pro buňky tabulky a řádky od aktuální polohy v dokumentu dále.
V této situaci se “aktuálem” rozumí poloha, odstavec, oddíl, buňka nebo řádek, ve kterém je kurzor.