Overzicht documentbouwer
DocumentBuilder is een machtige klasse die zich associeert met Document en kunt u dynamische documenten vanaf nul bouwen of nieuwe elementen toevoegen aan een bestaande.
DocumentBuilder voorziet in methoden om tekst, aanvinkkasten, 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 vormt een aanvulling op de in de Aspose.Words Document Object Model (DOM) vereenvoudiging van de meest voorkomende documentenopbouwtaken. 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 Direct. Gebruik Aspose.Words DOM klassen direct vereist meestal meer regels van code dan 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.move_to_XXX methoden zoals move_to_document_start en move_to_field. Deze virtuele cursor geeft aan waar de tekst zal worden ingevoegd bij het aanroepen van de methoden write, writeln, insert_break, en anderen. Zie het volgende artikel “Navigatie met Cursor” om meer te weten te komen over de virtuele cursor.
Het volgende voorbeeld van code laat zien hoe naar een bladwijzer te navigeren:
Documenten bouwen en wijzigen
Aspose.Words API verstrekt verschillende klassen die verantwoordelijk zijn voor het formatteren van verschillende elementen van een document. Elk van de klassen omvat opmaakeigenschappen die verband houden met een specifiek documentelement, zoals tekst, paragraaf, sectie en andere. Zo is het 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 documentbouw.
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.insert_XXX methoden, zoals insert_field, insert_html, 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 vereenzelvig het met een Document object. U 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 je een eenvoudig document maakt met behulp van een documentbouwer.
Documentopmaak specificeren
De font eigenschap definieert tekstopmaak. Dit object bevat verschillende lettertypeattributen (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 opmaak van tekens die zal worden toegepast op alle tekst die vanaf de huidige positie in het document wordt ingevoegd.
- paragraph_format specificeert de alinea-opmaak voor de huidige en alle in te voegen alinea’s.
- page_setup specificeert de pagina- en sectieeigenschappen voor het huidige gedeelte en de gehele sectie die zal worden ingevoegd.
- cell_format en row_format opmaakeigenschappen specificeren 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.