Pas Tabelformatering Toe

Elke element van’n tabel kan met verskillende formatering toegepas word. Byvoorbeeld, tabel formatering sal toegepas word op die hele tabel, ry formatering om slegs spesifieke rye, sel formatering om slegs sekere selle.

Aspose.Words bied’n ryk API om te haal en formatering toe te pas op’n tabel. Jy kan die Table, RowFormat, en CellFormat nodes gebruik om formatering te stel.

In hierdie artikel sal ons praat oor hoe om formatering toe te pas op verskillende tabel nodusse en watter tabel formatering instellings Aspose.Words ondersteun.

Pas Opmaak Toe Op Verskillende Nodusse

In hierdie afdeling, sal ons kyk na die toepassing van formatering om verskeie tabel nodes.

Tabelvlak Formatering

Om formatering toe te pas op’n tabel kan jy die eienskappe gebruik wat beskikbaar is op die ooreenstemmende Table knoop met behulp van die Table, PreferredWidth, en TableCollection klasse.

Let daarop dat die tabel ten minste een ry moet hê voordat die tabel eienskappe toegepas kan word. Dit beteken dat wanneer’n tabel met die DocumentBuilder gebou word, hierdie opmaak gedoen moet word na die eerste oproep na InsertCell, of nadat die eerste ry by die tabel gevoeg is, of wanneer nodusse direk in die DOM ingevoeg word.

Die foto’s hieronder toon’n voorstelling van die Table formatering funksies in Microsoft Word en hul ooreenstemmende eienskappe in Aspose.Words.

Die volgende kode voorbeeld toon hoe om’n omtrek grens toe te pas op’n tabel:

Die volgende kode voorbeeld toon hoe om’n tabel te bou met alle grense geaktiveer(rooster):

Ryvlak Formatering

Ry-vlak** formatering kan beheer word met behulp van die Row, RowFormat, en RowCollection klasse.

Let daarop dat a Row slegs’n kind-knooppunt van a Table kan wees. Terselfdertyd moet daar ten minste een Cell in die Row wees sodat die opmaak daarop toegepas kan word.

Die foto’s hieronder toon’n voorstelling van die Row formatering funksies in Microsoft Word en hul ooreenstemmende eienskappe in Aspose.Words.

Die volgende kode voorbeeld toon hoe om die tabel ry formatering te verander:

Selvlak Formatering

Selvlak-opmaak word beheer deur die Cell, CellFormat, en CellCollection klasse.

Let daarop dat a Cell slegs’n kind-knooppunt van a Row kan wees. Terselfdertyd moet daar ten minste een Paragraph in die Cell wees sodat die opmaak daarop toegepas kan word.

Benewens die Paragraph, kan jy ook a Table in a Cell invoeg.

Die foto’s hieronder toon’n voorstelling van die Cell formatering funksies in Microsoft Word en hul ooreenstemmende eienskappe in Aspose.Words.

Die volgende kode voorbeeld toon hoe om die formatering van’n tabel sel te verander:

Die volgende kode voorbeeld toon hoe om die hoeveelheid ruimte (in punte) te stel om by te voeg aan die linkerkant/bo / regs/onderkant van die inhoud van die sel:

Spesifiseer Ryhoogtes

Die eenvoudigste manier om die ry hoogte stel is om die DocumentBuilder gebruik. Deur die toepaslike RowFormat eienskappe te gebruik, kan jy die verstekhoogte-instelling stel of’n ander hoogte vir elke ry in die tabel toepas.

In Aspose.Words word die ryhoogte van die tabel beheer deur:

• die ryhoogte eienskap - Height
• die hoogte reël eienskap vir die gegewe ry - HeightRule

Terselfdertyd kan’n ander hoogte vir elke ry gestel word – dit laat jou toe om die tafelinstellings wyd te beheer.

Reël opsies vir die spesifisering van die hoogte van’n voorwerp kan ingestel word met behulp van die HeightRule velde.

Die volgende kode voorbeeld toon hoe om’n tabel wat’n enkele sel bevat te skep en ry formatering toe te pas:

Spesifiseer Tabel En Sel Breedtes

‘n tabel in’n Microsoft Word dokument bied verskeie verskillende maniere om die tabel en individuele selle te verander. Hierdie eienskappe laat aansienlike beheer oor die voorkoms en gedrag van die tabel toe, sodat Aspose.Words die gedrag van tabelle ondersteun, soos in Microsoft Word.

Dit is belangrik om te weet dat tabelelemente verskeie verskillende eienskappe het wat kan beïnvloed hoe die breedtes van die algehele tabel, sowel as individuele selle, bereken word:

• Voorkeurwydte op die tafel
• Voorkeur breedte op individuele selle
• Laat outofit op die tafel toe

Hierdie artikel gee besonderhede oor hoe die verskillende tabel breedte berekening eienskappe werk en hoe om volle beheer oor tabel breedte berekening te kry. Dit is veral nuttig om te weet in sulke gevalle waar die tabelopstelling nie soos verwag verskyn nie.

In die meeste gevalle word die voorkeursel aanbeveel as die tabelwydte. Die voorkeur sel breedte is meer in lyn met die DOCX formaat spesifikasie sowel as die Aspose.Words model.

Die sel breedte is eintlik’n berekende waarde vir die DOCX formaat. Die werklike selbreedte kan van baie dinge afhang. Byvoorbeeld, die verandering van die bladsy rande of die voorkeur tabel breedte kan die werklike sel breedte beïnvloed.

Die voorkeur sel breedte is’n sel eienskap wat in die dokument gestoor word. Dit hang nie van enigiets af nie en verander nie wanneer jy die tabel of ander eienskappe van die sel verander nie.

Alle eienskappe en metodes wat in hierdie artikel beskryf word, hou verband met hoe tabelle in Microsoft Word werk. So in die meeste gevalle, as jy jou tabel programmaties bou, maar dit moeilik vind om die gewenste tabel te skep, kan jy eerder probeer om dit eers visueel in Microsoft Word te skep en dan eenvoudig die formateringswaardes in jou aansoek te kopieer.

Hoe Om Voorkeur Breedte Te Gebruik

Die gewenste breedte van’n tabel of individuele selle word gedefinieer deur die voorkeur breedte eienskap, wat is die grootte wat’n element streef daarna om te pas. Dit wil sê, die voorkeurwydte kan vir die hele tabel of vir individuele selle gespesifiseer word. In sommige situasies is dit dalk nie moontlik om hierdie breedte presies te pas nie, maar die werklike breedte sal in die meeste gevalle naby hierdie waarde wees.

Die toepaslike voorkeur breedte tipe en waarde is ingestel met behulp van die metodes van die PreferredWidth klas:

• die Auto - veld om outomatiese of “geen voorkeurwydte” te spesifiseer nie
• die FromPercent metode om’n persentasie breedte spesifiseer
• die FromPoints metode om die breedte in punte spesifiseer

Die foto’s hieronder toon’n voorstelling van die preferred width setting features in Microsoft Word en hul ooreenstemmende eienskappe in Aspose.Words.

‘n voorbeeld van hoe hierdie opsies toegepas word op’n werklike tabel in’n dokument kan gesien word in die prentjie hieronder.

Voordat jy die voorkeurwydte in’n tabel kan gebruik, moet jy seker maak dat die tabel ten minste een ry bevat. Dit is omdat so’n tabel formatering in’n Microsoft Word dokument of in’n dokument geskep in Aspose.Words is gestoor in die rye van die tabel.

Spesifiseer Die Voorkeurtabel of Selwydte

In Aspose.Words word tabel-en selbreedtes ingestel met behulp van die Table.PreferredWidth eienskap en die CellFormat.PreferredWidth eienskap, met opsies beskikbaar in die PreferredWidthType opsomming:

• Auto, wat gelykstaande is aan geen voorkeur breedte stel
• Percent, wat pas by die element relatief tot die beskikbare ruimte in die venster of houer grootte, en herbereken die waarde wanneer die beskikbare breedte verander
• Points, wat ooreenstem met’n element van die gespesifiseerde breedte in punte

By verstek kan’n tabel beskryf word as 100% van die beskikbare ruimte op die bladsy. In hierdie geval beteken dit dat die tabel sal probeer om die ruimte tussen die linker-en regterbladmarges in te neem.

Die gebruik van die Table.PreferredWidth eienskap sal sy voorkeur breedte in verhouding tot sy houer aan te pas: bladsy, teks kolom, of buitenste tabel sel as dit’n geneste tabel.

Die volgende kode voorbeeld toon hoe om die tabel te stel om outomaties te pas by 50% van die bladsy breedte:

Die gebruik van die CellFormat.PreferredWidth eienskap op’n gegewe sel sal sy voorkeur breedte aan te pas.

Die volgende kode voorbeeld toon hoe om die verskillende voorkeur breedte instellings stel:

Vind Voorkeur Wydte Tipe En Waarde

Jy kan die Type en Value eienskappe gebruik om die voorkeur breedte besonderhede van die verlangde tabel of sel te vind.

Die volgende kode voorbeeld toon hoe om die voorkeur breedte tipe van’n tabel sel te haal:

Hoe Om Autofit Te Stel

Die AllowAutoFit eienskap laat selle in’n tabel toe om te groei en krimp volgens’n geselekteerde kriteria. U kan byvoorbeeld die AutoFit to Window - opsie gebruik om die tabel op die breedte van die bladsy te pas, en die AutoFit to Content - opsie om elke sel te laat groei of krimp volgens die inhoud daarvan.

Daarbenewens kan die AllowAutoFit eienskap gebruik word in samewerking met’n voorkeur sel breedte om’n sel wat outomaties pas by sy inhoud, maar het ook’n aanvanklike breedte te formateer. Indien nodig, kan die selbreedte dan verder as hierdie breedte groei.

By verstek, Aspose.Words voeg’n nuwe tabel met behulp van AutoFit to Window. Die tabel sal volgens die beskikbare bladsywydte gemeet word. Om’n tabel te verander, kan jy die AutoFit metode noem. Hierdie metode aanvaar’n AutoFitBehavior opsomming wat spesifiseer watter tipe van autofit toegepas word op die tabel.

Dit is belangrik om te weet dat die autofit metode is eintlik’n kortpad wat verskillende eienskappe van toepassing op die tabel op dieselfde tyd. Dit is eienskappe wat eintlik die tabel die waargenome gedrag gee. Ons sal hierdie eienskappe vir elke autofit-opsie bespreek.

Die volgende kode voorbeeld toon hoe om’n tabel te stel om elke sel te krimp of te groei volgens sy inhoud:

Ons sal die volgende tabel gebruik om die verskillende outomatiese pasinstellings as’n demonstrasie toe te pas.

AutoFit Tabel Na Venster

Wanneer outomatiese pas na’n venster op’n tafel toegepas word, word die volgende bewerkings eintlik agter die skerms uitgevoer:

1. Die Table.AllowAutoFit eienskap word geaktiveer om kolomme outomaties te verander om by die beskikbare inhoud te pas, met behulp van’n Table.PreferredWidth waarde van 100%
2. CellFormat.PreferredWidth is verwyder uit alle tabel selle
   Let daarop dat dit effens verskil van die Microsoft Word gedrag, waar elke sel se voorkeur breedte is ingestel op toepaslike waardes gebaseer op hul huidige grootte en inhoud. Aspose.Words werk nie die voorkeur breedte sodat hulle net kry skoongemaak in plaas daarvan.
3. Kolombreedtes word herbereken vir die huidige tabelinhoud - die eindresultaat is’n tabel wat die hele beskikbare breedte beslaan
4. Die breedte van die kolomme in die tabel verander outomaties as die gebruiker die teks wysig

Die volgende kode voorbeeld toon hoe om’n tabel outomaties te pas by die bladsy breedte:

‘n voorbeeld van hoe hierdie opsies op die tabel hierbo toegepas word, kan in die onderstaande prentjie gesien word.

AutoFit Tabel Tot Inhoud

Wanneer die tabel outomaties die inhoud is, word die volgende stappe eintlik agter die skerms uitgevoer:

1. Die Table.AllowAutoFit eienskap word geaktiveer om elke sel outomaties te verander volgens die inhoud daarvan

2. Die voorkeur tabel breedte is verwyder uit Table.PreferredWidth, CellFormat.PreferredWidth is verwyder vir elke tabel sel

   Let daarop dat hierdie autofit opsie verwyder die voorkeur breedte van selle, net soos in Microsoft Word. As jy die kolomgroottes wil behou en die kolomme wil vergroot of verminder om by die inhoud te pas, moet jy die Table.AllowAutoFit eienskap op True op sy eie stel eerder as om die autofit-kortpad te gebruik.

3. Kolombreedtes word herbereken vir die huidige tabelinhoud – die eindresultaat is’n tabel waar die kolombreedtes en die breedte van die hele tabel outomaties verander word om die inhoud die beste te pas wanneer die gebruiker die teks wysig

Die volgende kode voorbeeld toon hoe om’n tabel outomaties te pas by sy inhoud:

‘n voorbeeld van hoe hierdie opsies op die tabel hierbo toegepas word, kan in die onderstaande prentjie gesien word.

Deaktiveer AutoFit In Tabel En Gebruik Vaste Kolombreedtes

As’n tabel het autofit uitgeskakel en vaste kolom breedtes gebruik word in plaas daarvan, is die volgende stappe uitgevoer:

1. Table.AllowAutoFit eienskap is gedeaktiveer sodat kolomme nie groei of krimp tot hul inhoud
2. Die voorkeur breedte van die hele tabel is verwyder uit Table.PreferredWidth, CellFormat.PreferredWidth is verwyder uit alle tabel selle
3. Die eindresultaat is’n tabel waarvan die kolombreedtes bepaal word deur die CellFormat.Width eienskap, en waarvan die kolomme nie outomaties verander word wanneer die gebruiker teks invoer of wanneer die bladsy verander word nie

Let daarop dat indien geen breedte vir CellFormat.Width gespesifiseer word nie, die standaard waarde van een duim (72 punte) gebruik word.

Die volgende kode voorbeeld toon hoe om autofit deaktiveer en in staat stel vaste breedte vir die gespesifiseerde tabel:

‘n voorbeeld van hoe hierdie opsies op die tabel hierbo toegepas word, kan in die onderstaande prentjie gesien word.

Volgorde Van Voorrang wanneer Selbreedte Bereken Word

Aspose.Words laat gebruikers toe om die breedte van’n tabel of sel deur verskeie voorwerpe te definieer, insluitend CellFormat – sy Width eienskap is meestal oorblyfsels van vorige weergawes, maar dit is steeds nuttig om die selbreedte te vereenvoudig.

Dit is belangrik om te weet dat die CellFormat.Width eienskap anders werk, afhangende van watter van die ander breedte eienskappe reeds in die tabel bestaan.

Aspose.Words gebruik die volgende volgorde vir die berekening van sel breedtes:

Orde	Eiendom	Beskrywing
	AllowAutoFit is bepaal	As AutoFit geaktiveer is: - die tabel kan verby die voorkeurwydte groei om die inhoud te akkommodeer-dit krimp gewoonlik nie onder die voorkeurwydte nie - enige verandering aan die CellFormat.Width waarde word geïgnoreer en die sel sal pas by sy inhoud in plaas daarvan
	PreferredWidthType met’n waarde van Points of Percent	CellFormat.Width is geïgnoreer
	PreferredWidthType met’n waarde van Auto	Die waarde van CellFormat.Width word gekopieer en word die sel se voorkeurwydte (in punte)

Enige veranderinge aan die breedte eienskap word nie opgedateer in die voorkeur breedte en moet in plaas daarvan toegepas word op die voorkeur breedte in plaas daarvan.

Terwyl die skep van’n vaste tabel uitleg, spesifiseer die sel breedte. ‘n sel sonder breedte kan nie in DOC formaat gestoor word nie. Ander dokumentformate as DOC, soos DOCX, laat in beginsel toe om selle sonder breedte in’n vaste tabelopstelling te stoor.

Laat Spasiëring Tussen Selle Toe

Jy kan enige bykomende spasie tussen tabelselle kry of stel soortgelyk aan die opsie" Selspasiëring " in Microsoft Word. Dit kan gedoen word deur die AllowCellSpacing eienskap te gebruik.

‘n voorbeeld van hoe hierdie opsies toegepas word op’n werklike tabel in’n dokument kan gesien word in die prentjie hieronder.

Die volgende kode voorbeeld toon hoe om die afstand tussen selle stel:

Pas Grense en Skadu toe

Grens en skadu kan toegepas word op die hele tabel met behulp van Table.SetBorder, Table.SetBorders en Table.SetShading, of slegs op spesifieke selle met behulp van CellFormat.Borders en CellFormat.Shading. Daarbenewens kan ry grense gestel word met behulp van RowFormat.Borders, maar skadu kan nie op hierdie manier toegepas word nie.

Die foto’s hieronder toon die grens-en skadu-instellings in Microsoft Word en hul ooreenstemmende eienskappe in Aspose.Words.

Die volgende kode voorbeeld toon hoe om’n tabel en sel met verskillende grense en skakerings te formateer: