Tabelstijl Toepassen

Een tabelstijl definieert een set opmaak die gemakkelijk op een tabel kan worden toegepast. Opmaak zoals randen, schaduw, uitlijning en lettertype kunnen in een tabelstijl worden ingesteld en op veel tabellen worden toegepast voor een consistent uiterlijk.

Aspose.Words ondersteunt het toepassen van een tabelstijl op een tabel en ook het lezen van eigenschappen van elke tabelstijl. Tabelstijlen worden tijdens het laden en opslaan op de volgende manieren behouden:

  • Tabelstijlen in de indelingen DOCX en WordML blijven behouden bij het laden en opslaan in deze indelingen
  • Tabelstijlen blijven behouden bij het laden en opslaan in DOC - indeling (maar niet in een andere indeling)
  • Bij het exporteren naar andere indelingen, renderen of afdrukken worden tabelstijlen uitgebreid tot directe opmaak in de tabel, zodat alle opmaak behouden blijft

Een tabelstijl maken

De gebruiker kan een nieuwe stijl maken en deze toevoegen aan style collection. De methode Add wordt gebruikt om een Nieuwe tabelstijl te maken.

Het volgende codevoorbeeld laat zien hoe u een nieuwe door de gebruiker gedefinieerde tabelstijl maakt:

Een bestaande tabelstijl kopiëren

Indien nodig kunt u een tabelstijl die al bestaat in een bepaald document kopiëren naar uw stijlcollectie met behulp van de methode AddCopy.

Het is belangrijk om te weten dat bij dit kopiëren ook de gekoppelde stijlen worden gekopieerd.

Het volgende codevoorbeeld laat zien hoe u een stijl van het ene document naar het andere document importeert:

EXAMPLE

Een bestaande tabelstijl toepassen

Aspose.Words geeft een TableStyle geërfd van de Style klasse. TableStyle vergemakkelijkt de gebruiker om verschillende stijlopties toe te passen, zoals schaduw, opvulling, inspringing, CellSpacing en Font, enz.

Daarnaast biedt Aspose.Words de StyleCollection klasse en een paar eigenschappen van de Table klasse om aan te geven met welke tabelstijl we zullen werken: Style, StyleIdentifier, StyleName, en StyleOptions.

Aspose.Words biedt ook ConditionalStyle klasse die speciale opmaak vertegenwoordigt die wordt toegepast op een bepaald gebied van een tabel met een toegewezen tabelstijl, en de ConditionalStyleCollection die een verzameling ConditionalStyle objecten vertegenwoordigt. Deze collectie bevat een permanente set items die één item vertegenwoordigen voor elke waarde van het ConditionalStyleType opsommingstype. De ConditionalStyleType - opsomming definieert alle mogelijke tabelgebieden waarvoor voorwaardelijke opmaak in een tabelstijl kan worden gedefinieerd.

In dit geval kan voorwaardelijke opmaak worden gedefinieerd voor alle mogelijke tabelgebieden die zijn gedefinieerd onder het opsommingstype ConditionalStyleType.

Het volgende codevoorbeeld laat zien hoe voorwaardelijke opmaak voor kopregelrij van de tabel moet worden gedefinieerd:

U kunt ook kiezen op welke tabelonderdelen stijlen worden toegepast, zoals eerste kolom, laatste kolom en gestreepte rijen. Ze worden vermeld in de TableStyleOptions opsomming en worden toegepast via de StyleOptions eigenschap. De TableStyleOptions opsomming maakt een bitwise combinatie van deze kenmerken mogelijk.

Het volgende codevoorbeeld laat zien hoe u een nieuwe tabel maakt met een toegepaste tabelstijl:

De onderstaande afbeeldingen tonen een weergave van de Table Styles in Microsoft Word en hun overeenkomstige eigenschappen in Aspose.Words.

formatting-table-style-aspose-words-cpp

Neem opmaak van tabelstijl en pas het toe als directe opmaak

Aspose.Words biedt ook de ExpandTableStylesToDirectFormatting methode om opmaak gevonden op een tabelstijl te nemen en deze uit te breiden naar de rijen en cellen van de tabel als directe opmaak. Probeer opmaak te combineren met tabelstijl en celstijl.

Het volgende codevoorbeeld laat zien hoe u de opmaak van stijlen kunt uitbreiden naar tabelrijen en cellen als directe opmaak: