Skep'n Tabel

Aspose.Words laat gebruikers toe om tabelle in’n dokument van nuuts af te skep en bied verskeie verskillende metodes om dit te doen. Hierdie artikel bied besonderhede oor hoe om geformateerde tabelle by u dokument te voeg deur elke metode te gebruik, asook’n vergelyking van elke metode aan die einde van die artikel.

Verstek Tabel Style

Die nuutgeskepte tabel kry standaardwaardes soortgelyk aan die wat in Microsoft Wordgebruik word:

Tabel Eienskap	Verstek in Aspose.Words
`Border Style`	`Single`
`Border Width`	1/2 pt
`Border Color`	`Black`
`Left and Right Padding`	`5.4 pts`
`AutoFit Mode`	`AutoFit to Window`
`Allow AutoFit`	`True`

‘n tabel kan inlyn wees as dit styf geplaas is, of dryf as dit op enige plek op die bladsy geplaas kan word. By verstek skep Aspose.Words altyd inlyn tabelle.

Skep’n Tabel met DocumentBuilder

In Aspose.Words kan gebruikers’n tabel in’n dokument skep met behulp van die DocumentBuilder. Die basiese algoritme vir die skep van’n tabel is soos volg:

Begin die tabel met StartTable
Voeg’n sel by die tabel met InsertCell - dit begin outomaties’n nuwe ry
Gebruik opsioneel die CellFormat eienskap om selformatering te spesifiseer
Voeg die selinhoud in met behulp van die toepaslike DocumentBuilder metodes soos Writeln, InsertImage, en ander
Herhaal stappe 2-4 totdat die ry voltooi is
Roep EndRow om die huidige ry te beëindig
Opsioneel, gebruik die RowFormat eienskap om ry formatering spesifiseer
Herhaal stappe 2-7 totdat die tabel voltooi is
Bel EndTable om die tafel klaar te bou

Belangrike besonderhede:

StartTable kan ook binne’n sel genoem word, in watter geval dit die skepping van’n geneste tabel binne die sel begin.
Nadat jy InsertCell gebel het, word’n nuwe sel geskep, en enige inhoud wat jy byvoeg met behulp van ander metodes van die DocumentBuilder klas sal by die huidige sel gevoeg word. Om’n nuwe sel op dieselfde ry te skep, bel InsertCell weer.
As InsertCell onmiddellik na EndRow en die einde van’n ry genoem word, sal die tabel op’n nuwe ry voortgaan.
Die EndTable metode om die tabel te beëindig moet slegs een keer genoem word nadat EndRow geroep is. Roep EndTable beweeg die wyser van die huidige sel na die posisie onmiddellik na die tabel.

Die proses om’n tabel te skep, kan duidelik in die volgende prentjie gesien word:

creating-table-process

Die volgende kode voorbeeld toon hoe om’n eenvoudige tabel te skep met behulp van DocumentBuilder met standaard formatering:

Die volgende kode voorbeeld toon hoe om’n geformateerde tabel te skep met behulp van DocumentBuilder:

Die volgende kode voorbeeld toon hoe om’n geneste tabel te voeg met behulp van DocumentBuilder:

Skep’n Tabel via DOM (Dokumentobjekmodel)

Jy kan tabelle direk in die DOM invoeg deur’n nuwe Table knoop by’n spesifieke posisie by te voeg.

Let asseblief daarop dat onmiddellik na die tabelknoop skepping, die tabel self heeltemal leeg sal wees, dit wil sê dit bevat nog nie rye en selle nie. Om rye en selle in’n tabel in te voeg, voeg die toepaslike Row en Cell kind knope by die DOM.

Hierdie metode van die skep van’n tabel gebruik dieselfde tabel standaard as wanneer die gebruik van die DocumentBuilder.

Die volgende kode voorbeeld toon hoe om’n nuwe tabel van nuuts af te bou deur die toevoeging van die toepaslike kind nodes om die dokument boom:

Skep’n Tabel van HTML

Aspose.Words ondersteun die invoeging van inhoud in’n dokument van’n HTML bron met behulp van die InsertHtml metode. Die insette kan’n volledige HTML bladsy of net’n gedeeltelike uittreksel wees.

Met behulp van die InsertHtml metode, kan gebruikers tabelle in die dokument invoeg via tabel etikette soos <table>, <tr>, <td>.

Die volgende kode voorbeeld toon hoe om’n tabel in’n dokument van’n string wat HTML tags:

Voeg’n Kopie Van’n Bestaande Tabel in

Daar is dikwels tye wanneer jy’n tabel moet skep gebaseer op’n reeds bestaande tabel in’n dokument. Die maklikste manier om’n tabel te dupliseer terwyl al die formatering behou word, is om die Tabel-knooppunt te kloon met behulp van die Clone - metode.

Dieselfde tegniek kan gebruik word om kopieë van’n bestaande ry of sel by’n tabel te voeg.

Die volgende kode voorbeeld toon hoe om’n tabel te dupliseer met behulp van node konstruktors:

Die volgende kode voorbeeld toon hoe om die laaste ry van’n tabel te kloon en voeg dit by die tabel:

As u na tabelle in’n dokument kyk wat dinamies groei met elke rekord uit u databron, word die bogenoemde metode nie aanbeveel nie. In plaas daarvan word die gewenste uitset makliker bereik deur Mail merge met streke te gebruik. Jy kan meer leer oor hierdie tegniek in die Mail Merge Met Streke afdeling.

Vergelyk Maniere Om’n Tabel Te Skep

Aspose.Words bied verskeie metodes om nuwe tabelle in’n dokument te skep. Elke metode het sy eie voordele en nadele, so die keuse van wat om te gebruik hang dikwels af van die spesifieke situasie.

Kom ons kyk van naderby na hierdie maniere om tabelle te skep en vergelyk hul voor-en nadele:

Metode	Voordele	Nadele
`DocumentBuilder`	Die standaardmetode vir die invoeging van tabelle en ander dokumentinhoud	Soms moeilik om baie variëteite van tabelle te skep op dieselfde tyd met dieselfde bouer geval
Deur DOM	Pas in beter met omliggende kode wat nodes direk in die DOM skep en invoeg sonder om’n DocumentBuilderte gebruik	Die tabel word “leeg” geskep: voordat u die meeste bewerkings uitvoer, moet u EnsureMinimum skakel om ontbrekende kindknope te skep
Van HTML	Kan’n nuwe tabel van HTML bron met behulp van tags soos skep `<table>`, `<tr>`, `<td>`	Nie alle moontlike Microsoft Word tabel formate kan toegepas word op HTML
Kloning van’n bestaande tabel	U kan’n kopie van’n bestaande tabel skep terwyl u alle ry-en selformatering behou	Die toepaslike kind nodes moet verwyder word voordat die tabel gereed is vir gebruik

Tabel Oorsig Werk Met Kolomme en Rye in C++