Přehled Nástroje Pro Tvorbu Dokumentů

DocumentBuilder je výkonná třída, která se přidružuje k Document a umožňuje vytvářet dynamické dokumenty od nuly nebo přidávat nové prvky do existujícího.

DocumentBuilder

Tvůrce dokumentů nebo Aspose.Words DOM

DocumentBuilder

Operace, které jsou možné pomocí DocumentBuilder, jsou také možné při přímém použití tříd Aspose.Words DOM. Přímé použití tříd Aspose.Words DOM však obvykle vyžaduje více řádků kódu než použití DocumentBuilder.

Navigace V Dokumentu

Navigace v dokumentu je založena na konceptu virtuálního kurzoru, pomocí kterého se můžete přesunout na jiné místo v dokumentu pomocí různých metod DocumentBuilder.MoveToXXX, například MoveToDocumentStart a MoveToField. Tento virtuální kurzor označuje, kam bude text vložen při volání metod Write, Writeln, InsertBreak, a další.

Následující příklad kódu ukazuje, jak přejít na záložku:

Vytváření a úpravy dokumentů

Aspose.Words API poskytuje několik tříd, které jsou zodpovědné za formátování různých prvků dokumentu. Každá z tříd zapouzdřuje vlastnosti formátování související s konkrétním prvkem dokumentu, jako je text, odstavec, oddíl a další. Například třída Font představuje vlastnosti formátování znaků, třída ParagraphFormat představuje vlastnosti formátování odstavců atd. Objekty těchto tříd jsou vráceny odpovídajícími vlastnostmi DocumentBuilder, které mají stejné názvy jako třídy. Proto k nim můžete přistupovat a nastavit požadované formátování během vytváření dokumentu.

Můžete také vložit text, checkbox, objekt ole, obrázky, záložky, pole formuláře a další prvky dokumentu na pozici kurzoru pomocí metody Write nebo kterékoli z metod DocumentBuilder.InsertXXX, například InsertField, InsertHtml a podobných metod.

Podívejme se, jak vytvořit jednoduchý dokument pomocí DocumentBuilder.

Vytvoření dokumentu pomocí DocumentBuilder

Chcete-li začít, musíte vytvořit DocumentBuilder a přiřadit jej k objektu Document. Novou instanci DocumentBuilder vytvoříte voláním jejího konstruktoru a předáním objektu Document pro připojení k staviteli.

Chcete-li vložit text, předejte řetězec textu, který potřebujete vložit do dokumentu, metodě Write.

Následující příklad kódu ukazuje, jak vytvořit jednoduchý dokument pomocí nástroje pro tvorbu dokumentů.

Určete Formátování Dokumentu

Vlastnost Font definuje formátování textu. Tento objekt obsahuje různé atributy písma (název písma, velikost písma, barvu atd.). Některé důležité atributy písma jsou také reprezentovány vlastnostmi DocumentBuilder, které vám umožňují přímý přístup k nim. Jedná se o Font.Bold, Font.Italic a Font.Underline booleovské vlastnosti.

Následující příklad kódu ukazuje, jak vložit formátovaný text pomocí DocumentBuilder:

• Font určuje formátování znaků, které se použije na veškerý text vložený z aktuální pozice 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 oddílu pro aktuální oddíl a celý oddíl, který bude vložen.
• CellFormat a RowFormat určují vlastnosti formátování, které budou použity na buňky a řádky tabulky od aktuální pozice v dokumentu dále.

V této situaci “aktuální” znamená pozici, odstavec, sekci, buňku nebo řádek, ve kterém je kurzor.

Všimněte si, že vlastnosti Font, ParagraphFormat a PageSetup se aktualizují při každém přechodu do jiného umístění v dokumentu, aby odrážely vlastnosti formátování tohoto umístění.