Gebruik `DocumentBuilder` Om Dokumentelemente In Te Voeg

Die DocumentBuilder word gebruik om dokumente te verander. Hierdie artikel verduidelik en beskryf hoe om’n aantal take uit te voer:

Voeg’n String Teks in

Slaag eenvoudig die teksstring wat u in die dokument moet invoeg na die DocumentBuilder.Write - metode. Teks formatering word bepaal deur die Font eienskap. 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 Boole-eienskappe Font.Bold, Font.Italic, en Font.Underline.

Let daarop dat die karakterformatering wat u ingestel het, van toepassing sal wees op alle teks wat vanaf die huidige posisie in die dokument ingevoeg is.

Hieronder Voorbeeld Voeg geformateerde teks met behulp van DocumentBuilder.

Voeg’n Paragraaf by

DocumentBuilder.Writeln voeg ook’n string teks in die dokument in, maar dit voeg ook’n paragraafonderbreking by. Huidige lettertipe formatering word ook gespesifiseer deur die DocumentBuilder.Font eienskap en huidige paragraaf formatering word bepaal deur die DocumentBuilder.ParagraphFormat eienskap. Hieronder voorbeeld toon hoe om’n paragraaf in die dokument in te voeg.

Voeg’n Tabel by

Die basiese algoritme vir die skep van’n tabel met behulp van DocumentBuilder is eenvoudig:

1. Begin die tabel met DocumentBuilder.StartTable.
2. Voeg’n sel in met DocumentBuilder.InsertCell. Dit begin outomaties’n nuwe ry. Indien nodig, gebruik die DocumentBuilder.CellFormat eienskap om selformatering te spesifiseer.
3. Voeg selinhoud in met behulp van die DocumentBuilder metodes.
4. Herhaal stappe 2 en 3 totdat die ry voltooi is.
5. Roep DocumentBuilder.EndRow om die huidige ry te beëindig. Indien nodig, gebruik DocumentBuilder.RowFormat eienskap om ry formatering spesifiseer.
6. Herhaal stappe 2 - 5 totdat die tabel voltooi is.
7. Bel DocumentBuilder.EndTable om die tafelgebou te voltooi. Die toepaslike DocumentBuilder tabel skep metodes word hieronder beskryf.

Begin’n Tabel

Om DocumentBuilder.StartTable te bel is die eerste stap in die bou van’n tafel. Dit kan ook genoem word binne’n sel, in watter geval dit begin’n geneste tafel. Die volgende metode om te bel is DocumentBuilder.InsertCell.

Voeg’n Sel in

Nadat jy DocumentBuilder->InsertCell gebel het, word’n nuwe sel geskep en enige inhoud wat jy byvoeg met ander metodes van die DocumentBuilder klas sal by die huidige sel gevoeg word. Om’n nuwe sel in dieselfde ry te begin, bel DocumentBuilder->InsertCell weer. Gebruik die DocumentBuilder.CellFormat eienskap om selformatering te spesifiseer. Dit gee’n CellFormat voorwerp wat al die formatering vir’n tabel sel verteenwoordig.

Einde Van’n Ry

Bel DocumentBuilder.EndRow om die huidige ry te voltooi. As jy DocumentBuilder->InsertCell onmiddellik daarna bel, gaan die tabel voort op’n nuwe ry.

Gebruik die DocumentBuilder.RowFormat eienskap om ry formatering spesifiseer. Dit gee’n RowFormat voorwerp wat al die formatering vir’n tabel ry verteenwoordig.

Die Einde Van’n Tafel

Bel DocumentBuilder.EndTable om die huidige tabel te voltooi. Hierdie metode moet slegs een keer genoem word nadat DocumentBuilder->EndRow genoem is. Wanneer genoem, DocumentBuilder.EndTable beweeg die wyser uit die huidige sel na’n posisie net na die tabel. Die volgende voorbeeld demonstreer hoe om’n geformateerde tabel te bou wat 2 rye en 2 kolomme bevat.

Voeg’n Breek in

As u uitdruklik’n nuwe reël, paragraaf, kolom, afdeling of bladsy wil begin, skakel DocumentBuilder.InsertBreak. Gee aan hierdie metode die tipe breek wat u moet invoeg wat deur die BreakType opsomming voorgestel word. Hieronder voorbeeld toon hoe om bladsy breek in’n dokument in te voeg.

Voeg’n Prent in

DocumentBuilder bied verskeie oorladings van die DocumentBuilder->InsertImage metode wat jou toelaat om’n inlyn of drywende beeld in te voeg. As die beeld’n EMF of WMF metafile is, sal dit in die dokument in metafile-formaat ingevoeg word. Alle ander beelde sal in PNG formaat gestoor word. Die DocumentBuilder->InsertImage metode kan beelde van verskillende bronne gebruik:

• Van’n lêer of URL deur’n string parameter DocumentBuilder->InsertImage te slaag.
• Van’n stroom deur’n Stream parameter DocumentBuilder->InsertImage te slaag.
• Van’n Beeld voorwerp deur’n Beeld parameter DocumentBuilder->InsertImage.
• Van’n byte skikking deur’n byte skikking parameter DocumentBuilder.InsertImage te slaag.Vir elk van die DocumentBuilder->InsertImage metodes, is daar verdere oorladings wat jou toelaat om’n beeld met die volgende opsies in te voeg:
• Inlyn of dryf op’n spesifieke posisie, byvoorbeeld, DocumentBuilder->InsertImage.
• Persentasie skaal of persoonlike grootte, byvoorbeeld, DocumentBuilder.InsertImage. Verder die DocumentBuilder->InsertImage metode gee’n Shape voorwerp wat net geskep en ingevoeg sodat jy verder kan verander eienskappe van die vorm.

Voeg’n Inlynbeeld in

Gee’n enkele string wat’n lêer verteenwoordig wat die beeld bevat na DocumentBuilder->InsertImage om die beeld in die dokument as’n inlyngrafika in te voeg. Hieronder voorbeeld toon hoe om’n inline beeld by die wyser posisie in’n dokument in te voeg.

Voeg’n Drywende (Absoluut Geposisioneer) Beeld in

Hierdie voorbeeld voeg’n drywende beeld van’n lêer of URL by’n gespesifiseerde posisie en grootte.

Voeg’n Boekmerk in

Om’n boekmerk in die dokument in te voeg, moet jy die volgende doen:

1. Bel DocumentBuilder->StartBookmark verby dit die gewenste naam van die boekmerk.
2. Voeg die boekmerk teks met behulp van DocumentBuilder metodes.
3. Noem DocumentBuilder.EndBookmark verby dit dieselfde naam wat jy gebruik met DocumentBuilder->StartBookmark.
4. Boekmerke kan oorvleuel en enige reeks oorskry. Om’n geldige boekmerk te skep, moet jy beide DocumentBuilder->StartBookmark en DocumentBuilder->EndBookmark met dieselfde boekmerknaam bel.

Swak gevormde boekmerke of boekmerke met dubbele name sal geïgnoreer word wanneer die dokument gestoor word.

Die onderstaande voorbeeld toon hoe om’n boekmerk in’n dokument in te voeg met behulp van’n dokumentbouer.

Voeg’n Form Veld in

Vorm velde is’n spesifieke geval van Woord velde wat “interaksie” met die gebruiker toelaat. Vorm velde in Microsoft Word sluit teksboks, kombinasie boks en boks.DocumentBuilder bied spesiale metodes om elke tipe vormveld in die dokument in te voeg: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox, en DocumentBuilder.InsertComboBox. Let daarop dat as u’n naam vir die vormveld spesifiseer, ‘n boekmerk outomaties met dieselfde naam geskep word.

Voeg’n Teks Invoer in

DocumentBuilder.InsertTextInput om’n teksblokkie in die dokument in te voeg. Hieronder voorbeeld toon hoe om’n teks invoer vorm veld in’n dokument in te voeg.

Voeg’n Boks In

Bel DocumentBuilder.InsertCheckBox om’n boks in die dokument in te voeg. Hieronder voorbeeld toon hoe om’n boks vorm veld in’n dokument in te voeg.

Voeg’n Kombinasie Boks in

Bel DocumentBuilder.InsertComboBox om’n kombinasie boks in die dokument in te voeg. Hieronder voorbeeld toon hoe om’n kombinasie boks vorm veld in’n dokument in te voeg.

Invoeging Van Ligging Op Veldvlak

Kliënte kan Nou Die Ligging op veldvlak spesifiseer en kan beter beheer verkry. Locale Id’s kan geassosieer word met elke veld binne die DocumentBuilder. Die voorbeelde hieronder illustreer hoe om van hierdie opsie gebruik te maak.

Voeg’n Hiperskakel in

Gebruik DocumentBuilder.InsertHyperlink om’n hiperskakel in die dokument in te voeg. Hierdie metode aanvaar drie parameters: teks van die skakel wat in die dokument vertoon moet word, skakelbestemming (URL of’n naam van’n boekmerk binne die dokument), en’n booleaanse parameter wat waar moet wees as die URL ‘n naam van’n boekmerk binne die dokument is.DocumentBuilder.InsertHyperlink intern oproepe DocumentBuilder.InsertField.Die metode voeg altyd apostrofes by aan die begin en einde van die URL. Let daarop dat jy font formatering vir die hyperlink vertoon teks eksplisiet met behulp van die Font eiendom spesifiseer. Hieronder voorbeeld voeg’n hiperskakel in’n dokument met behulp van DocumentBuilder.

Invoeging Van Ole Voorwerp

As jy Wil Ole Voorwerp bel DocumentBuilder.InsertOleObject. Gee aan hierdie metode die ProgId eksplisiet met ander parameters. Hieronder voorbeeld toon hoe Om Ole Voorwerp in’n dokument in te voeg.

Stel Lêernaam en Uitbreiding wanneer Ole-Voorwerp Ingevoeg Word

OLE pakket is’n erfenis en “ongedokumenteerde” manier om ingebedde voorwerp te stoor as OLE handelaar is onbekend. Vroeë Windows weergawes soos Windows 3.1, 95 en 98 het Verpakker gehad.exe aansoek wat gebruik kan word om enige tipe data in die dokument te insluit. Nou, hierdie aansoek is uitgesluit van Windows maar MS Word en ander programme gebruik dit nog steeds om data te insluit as OLE handelaar ontbreek of onbekend is. OlePackage klas kan toegang tot OLE Pakket eienskappe. Hieronder voorbeeld toon hoe om lêernaam, uitbreiding en vertoon naam vir OLE Pakket stel.

Voeg by HTML

Jy kan maklik’n HTML string wat’n HTML fragment of hele HTML dokument bevat in die Word-dokument invoeg. Slaag net hierdie string na die DocumentBuilder->InsertHtml metode. Een van die nuttige implementasies van die metode is om’n HTML string in’n databasis te stoor en dit in die dokument in te voeg tydens mail merge om die geformateerde inhoud by te voeg in plaas daarvan om dit te bou met behulp van verskillende metodes van die dokumentbouer. Hieronder voorbeeld toon insetsels HTML in’n dokument met behulp van DocumentBuilder.

Voeg Horisontale Reël in Dokument in

Below code voorbeeld toon hoe om horisontale reël vorm in’n dokument te voeg met behulp van DocumentBuilder->InsertHorizontalRule metode.