Dokumentbouer Oorsig
DocumentBuilder is’n kragtige klas wat met Document assosieer en jou in staat stel om dinamiese dokumente van nuuts af te bou of nuwe elemente by’n bestaande een te voeg.
DocumentBuilder bied metodes om teks, checkboxes, ole voorwerpe, paragrawe, lyste, tabelle, beelde, en ander inhoud elemente in te voeg. Dit laat jou toe om lettertipes, paragraaf of afdeling formatering spesifiseer, en voer ander bewerkings.
Dokumentbouer of Aspose.Words DOM
DocumentBuilder vul klasse en metodes beskikbaar in die Aspose.Words Document Object Model (DOM) om die mees algemene dokument gebou take te vereenvoudig. Dit wil sê, jy kan die inhoud van dokumente skep en verander deur beide die Aspose.Words DOM, wat’n goeie begrip van die boomstruktuur vereis, en die gebruik van die DocumentBuilder. Die DocumentBuilder is’n “fasade” vir die komplekse Document struktuur wat jou toelaat om vinnig en maklik inhoud en formatering in te voeg.
Operasies wat moontlik is met DocumentBuilder is ook moontlik wanneer die klasse van die Aspose.Words DOM direk gebruik word. Maar die gebruik van Aspose.Words DOM klasse direk vereis gewoonlik meer reëls kode as die gebruik van DocumentBuilder.
Dokument Navigasie
Dokumentnavigasie is gebaseer op die konsep van’n virtuele wyser, waarmee jy na’n ander plek in die dokument kan beweeg met behulp van verskeie DocumentBuilder.move_to_XXX metodes soos move_to_document_start en move_to_field. Hierdie virtuele wyser dui aan waar die teks ingevoeg sal word wanneer die metodes geroep word write, writeln, insert_break, en ander. Sien die volgende artikel “Navigasie met Wyser” om meer te leer oor die virtuele wyser.
Die volgende kode voorbeeld toon hoe om te navigeer na’n boekmerk:
Dokumentbou En Wysiging
Aspose.Words API bied verskeie klasse wat verantwoordelik is vir die formatering van verskeie elemente van’n dokument. Elk van die klasse inkapsel formatering eienskappe wat verband hou met’n spesifieke dokument element, soos teks, paragraaf, afdeling, en ander. Byvoorbeeld, die Font klas verteenwoordig karakter formatering eienskappe, die ParagraphFormat klas verteenwoordig paragraaf formatering eienskappe, en so aan. Voorwerpe van hierdie klasse word teruggestuur deur die ooreenstemmende DocumentBuilder eienskappe, wat dieselfde name as die klasse het. Daarom kan u toegang tot hulle kry en die verlangde formatering tydens die dokumentbou stel.
Jy kan ook voeg teks, checkbox, ole voorwerp, beelde, boekmerke, vorm velde, en ander dokument elemente by die wyser posisie met behulp van die Write metode of enige van die DocumentBuilder.insert_XXX metodes, soos insert_field, insert_html, en soortgelyke metodes.
Kom ons kyk hoe om’n eenvoudige dokument te skep met behulp van die DocumentBuilder.
Skep’n Dokument met DocumentBuilder
Om te begin, moet jy’n DocumentBuilder skep en dit met’n Document voorwerp assosieer. Jy skep’n nuwe voorbeeld van DocumentBuilder deur sy konstruktor te bel en dit aan’n Document voorwerp te gee vir aanhegting aan die bouer.
Om’n teks in te voeg, slaag die teksstring wat u in die dokument moet invoeg na die write - metode.
Die volgende kode voorbeeld toon hoe om’n eenvoudige dokument te skep met behulp van’n dokument bouer.
Spesifiseer Dokumentformatering
Die font eienskap definieer teks formatering. Hierdie voorwerp bevat verskillende lettertipe eienskappe (lettertipe naam, lettertipe grootte, kleur, en so aan). Sommige belangrike lettertipe-eienskappe word ook verteenwoordig deur DocumentBuilder eienskappe om jou in staat te stel om direk toegang tot hulle te verkry. Dit is die Font.bold, Font.italic, en Font.underline booleaanse eienskappe.
Die volgende kode voorbeeld toon hoe om’n geformateerde teks in te voeg met behulp van DocumentBuilder:
- font spesifiseer die karakterformatering wat toegepas sal word op alle teks wat vanaf die huidige posisie in die dokument ingevoeg word.
- paragraph_format spesifiseer die paragraafformatering vir die huidige en alle paragrawe wat ingevoeg moet word.
- page_setup spesifiseer die bladsy-en afdelingseienskappe vir die huidige afdeling en die hele afdeling wat ingevoeg sal word.
- cell_format en row_format spesifiseer formatering eienskappe wat toegepas sal word om tabel selle en rye van die huidige posisie in die dokument af.
In hierdie situasie beteken “huidige” die posisie, paragraaf, gedeelte, sel of ry waarin die wyser is.