Overzicht documentbouwer
DocumentBuilder is een krachtige klasse die zich associeert met Document en kunt u dynamische documenten vanaf nul bouwen of nieuwe elementen toevoegen aan een bestaande.
DocumentBuilder biedt methoden om tekst, checkboxen, ole objecten, paragrafen, lijsten, tabellen, afbeeldingen en andere inhoudselementen in te voegen. Hiermee kunt u lettertypen, alinea of sectieopmaak specificeren en andere bewerkingen uitvoeren.
Documentbouwer of Aspose.Words DOM
DocumentBuilder vult klassen en methoden aan die beschikbaar zijn in de Aspose.Words Document Object Model (DOM) vereenvoudiging van de meest voorkomende documentenbouwtaken. Dat wil zeggen, u kunt de inhoud van documenten zowel via de Aspose.Words DOM, wat een goed begrip van de boomstructuur vereist, en het gebruik van de DocumentBuilder. De DocumentBuilder is een “gevel” voor het complex Document structuur waarmee u snel en eenvoudig inhoud en opmaak kunt invoegen.
Operaties die mogelijk zijn met DocumentBuilder zijn ook mogelijk bij het gebruik van de klassen van de Aspose.Words DOM rechtstreeks. Gebruik Aspose.Words DOM klassen vereisen meestal meer regels code dan het gebruik DocumentBuilder.
Documentnavigatie
Documentnavigatie is gebaseerd op het concept van een virtuele cursor, waarmee u naar een andere locatie in het document met behulp van verschillende DocumentBuilder.MoveToXXX methoden zoals MoveToDocumentStart en MoveToField. Deze virtuele cursor geeft aan waar de tekst zal worden ingevoegd bij het aanroepen van de methoden Write, Writeln, InsertBreak, en anderen. Zie het volgende artikel “Navigatie met Cursor” om meer te weten te komen over de virtuele cursor.
Het volgende codevoorbeeld laat zien hoe u naar een bladwijzer kunt navigeren:
Documenten bouwen en wijzigen
Aspose.Words API biedt verschillende klassen die verantwoordelijk zijn voor het formatteren van verschillende elementen van een document. Elk van de klassen omvat opmaakeigenschappen met betrekking tot een specifiek documentelement, zoals tekst, paragraaf, sectie en andere. Zo is er bijvoorbeeld de Font klasse vertegenwoordigt karakteropmaak eigenschappen, de ParagraphFormat klasse vertegenwoordigt alinea-opmaak eigenschappen, enzovoort. Objecten van deze klassen worden teruggegeven door de overeenkomstige DocumentBuilder eigenschappen die dezelfde namen hebben als de klassen. Daarom kunt u ze openen en de gewenste opmaak instellen tijdens de document build.
U kunt ook tekst, selectievakje, ole object, afbeeldingen, bladwijzers, formuliervelden en andere document elementen op de cursor positie invoegen met behulp van de Write methode of een van de DocumentBuilder.InsertXXX methoden, zoals InsertField, InsertHtml, en soortgelijke methoden.
Eens kijken hoe je een eenvoudig document aanmaakt met de DocumentBuilder.
Een document aanmaken met DocumentBuilder
Om te beginnen moet je een DocumentBuilder en vereenzelvigt het met een Document object. Je maakt een nieuwe instantie van DocumentBuilder door de constructeur aan te roepen en door te geven aan een Document object voor bevestiging aan de bouwer.
Geef om een tekst in te voegen de tekstreeks die u in het document moet invoegen aan de Write methode.
Het volgende voorbeeld van code laat zien hoe u een eenvoudig document kunt maken met behulp van een documentbouwer.
Documentopmaak specificeren
De Font eigenschap definieert tekstopmaak. Dit object bevat verschillende lettertype-attributen (lettertypenaam, lettergrootte, kleur, enzovoort). Enkele belangrijke lettertype-attributen worden ook vertegenwoordigd door DocumentBuilder eigenschappen waarmee u ze direct kunt openen. Dit zijn de Font.Bold, Font.Italic, en Font.Underline Booleaanse eigendommen.
Het volgende voorbeeld van code laat zien hoe je een geformatteerde tekst invoegt met behulp van DocumentBuilder:
- Font specificeert de karakteropmaak die zal worden toegepast op alle tekst die vanaf de huidige positie in het document wordt ingevoegd.
- ParagraphFormat specificeert de alinea-opmaak voor de huidige en alle in te voegen alinea’s.
- PageSetup specificeert de pagina- en sectieeigenschappen voor het huidige gedeelte en de gehele sectie die zal worden ingevoegd.
- CellFormat en RowFormat formatteer eigenschappen die vanaf de huidige positie in het document op tabelcellen en rijen zullen worden toegepast.
In deze situatie betekent “huidig” de positie, paragraaf, sectie, cel of rij waarin de cursor zich bevindt.