Werken met lijsten

Een lijst in een Microsoft Word document is een verzameling van alinea-opmaakeigenschappen. Lijsten kunnen worden gebruikt in documenten om tekst te structureren, ordenen en markeren. Lijsten zijn een geweldige manier om gegevens in documenten te organiseren op een manier die het gemakkelijk maakt voor lezers om belangrijke punten te absorberen en te begrijpen.

Elke lijst kan maximaal 9 niveaus hebben, en opmaakeigenschappen zoals nummerstijl, startwaarde, inspringing, tab positie, en anderen zijn apart gedefinieerd voor elk niveau.

In Aspose.Words, het werken met lijsten wordt vertegenwoordigd door de Lists naamruimte. De List object altijd behoort tot de ListCollection.

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:

De kogel of het nummer en de opmaak worden toegevoegd aan de huidige alinea en alle verdere alinea’s die zijn 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 ListIndent
  • Om het lijstniveau van de huidige paragraaf met één niveau te verlagen, aanroepen ListOutdent

U kunt ook de ListLevelNumber eigenschap om het lijstniveau voor de alinea te verkrijgen of in te stellen.

Het volgende voorbeeld van code laat zien hoe een multilevel lijst te bouwen:

Opmaak opgeven voor een lijstniveau

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 documentformaten. Deze optie wordt alleen naar DOCX geschreven als OoxmlCompliance hoger is dan Ecma376.

Het volgende voorbeeld van code laat zien hoe u een lijst aanmaakt en herstart voor elke sectie:

Werk met tabellen in C# Werken met alinea's in C#