Werken met lijsten
Een lijst in een Microsoft Word document is een verzameling van lijstopmaak eigenschappen. Lijsten kunnen in uw documenten worden gebruikt om tekst te formatteren, ordenen en benadrukken. Lijsten zijn een geweldige manier om gegevens in documenten te organiseren, en ze maken het voor lezers gemakkelijker om belangrijke punten te begrijpen.
Elke lijst kan tot 9 niveaus en opmaakeigenschappen hebben, zoals nummerstijl, startwaarde, streepje, tabpositie, en andere worden apart gedefinieerd voor elk niveau.
Dit artikel beschrijft programmamatisch werken met lijsten met Aspose.Words.
Lijsten aanmaken door lijstopmaak toe te passen
Aspose.Words maakt het gemakkelijk lijsten aan te maken door lijstopmaak toe te passen. DocumentBuilder levert de ListFormat eigenschap die een ListFormat object. Dit object heeft verschillende methoden om een lijst te starten en te beëindigen en het streepje te verhogen/verlaagen. Er zijn twee algemene soorten lijsten in Microsoft Word: kogels en nummers:
- Om een lijst met kogels te beginnen, bel ListFormat.ApplyBulletDefault
- Om een genummerde lijst te starten, bel ListFormat.ApplyNumberDefault
De bullet of nummer en formattering worden toegevoegd aan de huidige paragraaf en alle verdere alinea’s gemaakt met behulp van DocumentBuilder tot RemoveNumbers wordt opgeroepen om te stoppen met het formatteren van de lijst met kogels.
In Word-documenten kunnen lijsten bestaan uit maximaal negen niveaus. Lijstopmaak voor elk niveau geeft aan welke kogel of getal wordt gebruikt, linker streepje, ruimte tussen de kogel en tekst enz. De volgende methoden veranderen het lijstniveau en passen de opmaakeigenschappen van het nieuwe niveau toe:
- Om het lijstniveau van de huidige paragraaf met één niveau te verhogen, roep ListFormat.ListIndent
- Om het lijstniveau van de huidige paragraaf met één niveau te verlagen, aanroepen ListFormat.ListOutdent
De methoden veranderen het lijstniveau en passen de opmaakeigenschappen van het nieuwe niveau toe.
Het volgende voorbeeld toont hoe je een multilevel lijst kunt bouwen:
Formatteren voor een lijstniveau specificeren
Lijst-niveau objecten worden automatisch aangemaakt wanneer een lijst wordt aangemaakt. Gebruik de eigenschappen en methoden van de ListLevel klasse om de opmaak van individuele niveaus van een lijst te controleren.
Lijst herstarten voor elke sectie
U kunt een lijst herstarten voor elke sectie met behulp van de IsRestartAtEachSection eigendom. Merk op dat deze optie alleen wordt ondersteund in RTF, DOC en DOCX document formaten. Deze optie wordt alleen naar DOCX geschreven als OoxmlCompliance hoger is dan Ecma376.
Het volgende voorbeeld van code laat zien hoe je een lijst aanmaakt en herstart voor elke sectie: