Werken met lijsten

Overzicht

Deze gids toont hoe genummerde en opsommingstekens-lijsten worden weergegeven en beheerd in Aspose.Words FOSS voor .NET. Een List is een herbruikbare lijstdefinitie die door elke alinea die het gebruikt wordt gedeeld, ListFormat is hoe een individuele alinea naar een lijst en het huidige niveau verwijst, en ListLevel bevat de daadwerkelijke nummerings- of opsommingstekenopmaak voor één niveau van een lijst.


Het lijstobject en ListCollection

List vertegenwoordigt één lijstdefinitie — de nummeringsregels die een document op veel alinea’s kan toepassen. List.ListId identificeert het, List.IsMultiLevel geeft aan of het meer dan één niveau definieert, en List.ListLevels retourneert een ListLevelCollection die één ListLevel per niveau dat de lijst definieert bevat. List.IsListStyleDefinition en IsListStyleReference onderscheiden een lijst die zijn eigen opmaak definieert van een lijst die opmaak verwijst via een gelinkte Style (beschikbaar via List.Style). De lijsten van elk document worden benaderd via Document.Lists, die een ListCollection retourneert: ListCollection.Add(listTemplate) maakt een nieuwe lijst aan op basis van een van Word’s vooraf gedefinieerde ListTemplate formats, Add(listStyle) maakt er één aan vanuit een Style, AddSingleLevelList(listTemplate) maakt een enkel-niveau variant, en AddCopy(srcList) dupliceert een bestaande lijst — nuttig wanneer je alinea’s een onafhankelijke nummering wilt geven (een frisse herstart) in plaats van dezelfde teller te delen. ListCollection.GetListByListId(listId) haalt een specifieke lijst op, en Count geeft aan hoeveel lijsten het document heeft.

Lijsten toepassen op alinea’s met ListFormat

ListFormat, bereikt vanuit de opmaak van een alinea, bepaalt tot welke lijst een alinea behoort en op welk niveau. ListFormat.List is de List die de alinea gebruikt, en ListFormat.ListLevelNumber is het nul-gebaseerde niveau binnen die lijst; IsListItem geeft aan of de alinea überhaupt deel uitmaakt van een lijst. ApplyBulletDefault() en ApplyNumberDefault() passen de standaard opsomming- of genummerde lijstopmaak van Word toe op een alinea in één oproep, RemoveNumbers() verwijdert de lijstopmaak, en ListIndent()/ListOutdent() verplaatsen een alinea dieper in of ondieper uit de niveaus van de lijst — dezelfde bewerkingen die Word uitvoert bij het indrukken van Tab of Shift+Tab aan het begin van een lijstalinea.

Lijstniveaus en nummeringsstijl

ListLevel bevat de opmaak voor één niveau van een lijst: NumberStyle (een NumberStyle enum-waarde zoals Arabische cijfers of Romeinse cijfers), NumberFormat (de opmaak-string die het nummer combineert met letterlijke tekst, zoals een punt of haakje), StartAt (het startnummer), en RestartAfterLevel (welk hoger niveau’s increment deze teller opnieuw start). Alignment (een ListLevelAlignment waarde: Left, Center, Right) en TrailingCharacter (een ListTrailingCharacter waarde: Tab, Space, Nothing) bepalen hoe het label wordt gepositioneerd en gescheiden van de alinea-tekst, samen met TabPosition, NumberPosition en TextPosition voor precieze lay-out. IsLegal dwingt een juridische nummering (altijd Arabisch, ongeacht NumberStyle), en LinkedStyle koppelt het niveau aan een alinea Style. Voor afbeelding-bullets beheren CreatePictureBullet() en DeletePictureBullet() een ImageData bullet-afbeelding, en ListLevel.Font stelt de opmaak van het nummer of bullet-teken zelf in. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) berekent de daadwerkelijke labelwaarde op een gegeven positie in de nummeringsreeks.

Lijstlabels en vooraf gedefinieerde sjablonen

ListLabel beschrijft het gerenderde label voor een specifiek lijstitem-exemplaar — LabelString is de letterlijke tekst die Word weergeeft (zoals “3.” of “•”), LabelValue is de onderliggende numerieke waarde, en Font is de opmaak van het label. ListTemplate is een enum van Word’s vooraf gedefinieerde lijstformaten (bullet-stijlen zoals BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds, en genummerde formaten), gebruikt met ListCollection.Add(listTemplate) om te starten vanaf een ingebouwd formaat in plaats van één eigenschap per keer op te bouwen.


Tips en best practices

  • Gebruik ListCollection.AddCopy(srcList) wanneer een nieuwe groep alinea’s een lijstnummering nodig heeft die onafhankelijk opnieuw begint, in plaats van een List opnieuw te gebruiken die al aan andere alinea’s gekoppeld is.
  • Geef de voorkeur aan ListFormat.ApplyNumberDefault() / ApplyBulletDefault() voor standaardlijsten in plaats van elke ListLevel eigenschap handmatig te configureren.
  • Controleer List.IsListStyleReference versus IsListStyleDefinition voordat je de lijstopmaak direct wijzigt — de opmaak van een stijl-verwijzende lijst kan worden beheerd door de gekoppelde Style.
  • Stel RestartAfterLevel expliciet in op geneste lijsten in plaats van te vertrouwen op het standaardherstartgedrag wanneer nummering moet worden gereset op specifieke outline-niveaus.
  • Gebruik ListFormat.ListIndent()/ListOutdent() om een alinea tussen lijstniveaus te verplaatsen in plaats van ListLevelNumber direct in te stellen, omdat deze methoden de lijstopmaak van de alinea intern consistent houden.

Veelvoorkomende problemen

ProbleemOorzaakOplossing
Twee alinea’s die onafhankelijk genummerd moeten worden, blijven dezelfde reeks voortzettenDe ListFormat.List van beide alinea’s verwijst naar hetzelfde gedeelde List objectGeef de tweede alinea zijn eigen lijst via ListCollection.AddCopy(srcList) in plaats van dezelfde List opnieuw te gebruiken
Een aangepaste nummeringsformaat-tekenreeks wordt niet zoals verwacht weergegevenListLevel.NumberFormat komt niet overeen met het verwachte patroon voor het NumberStyle van het niveauControleer of NumberFormat en NumberStyle consistent zijn ingesteld voor het bewerkte niveau
De inspringing van de lijst ziet er verkeerd uit na het programmatisch wijzigen van niveausListLevelNumber werd direct ingesteld zonder de gerelateerde positie-eigenschappen bij te werkenGebruik ListFormat.ListIndent()/ListOutdent() in plaats van ListLevelNumber rechtstreeks in te stellen
Er verschijnt geen afbeeldingstekenEr is geen afbeeldingsteken voor het niveau aangemaakt, of de standaard tekstopmaak voor opsommingstekens is nog actiefRoep ListLevel.CreatePictureBullet() aan en lever de afbeeldingsgegevens voordat de tekstopmaak voor opsommingstekens wordt verwijderd

FAQ

Wat is het verschil tussen List en ListFormat?

List is de herbruikbare nummering/kogel-definitie die over alinea’s wordt gedeeld; ListFormat is per alinea — het wijst op welke List een specifieke alinea gebruikt en op welk niveau, via ListFormat.List en ListLevelNumber.

Hoe controleer ik of een alinea deel uitmaakt van een lijst?

Lees ListFormat.IsListItem over de opmaak van de alinea; als true, ListFormat.List en ListLevelNumber beschrijven tot welke lijst en niveau deze behoort.

Hoe zorg ik ervoor dat een nieuwe lijst onafhankelijk van een bestaande lijst vanaf 1 begint te nummeren?

Gebruik ListCollection.AddCopy(srcList) om een onafhankelijke kopie van de lijstdefinitie te maken, en pas vervolgens de kopie toe op de nieuwe alinea’s — in plaats van de oorspronkelijke List te hergebruiken, waardoor dezelfde teller wordt voortgezet.

Hoe maak ik een opsomming met opsommingstekens of een genummerde lijst vanaf nul?

Gebruik ListFormat.ApplyBulletDefault() of ApplyNumberDefault() voor de standaardopmaak van Word, of ListCollection.Add(listTemplate) met een ListTemplate-waarde om te beginnen met een van de vooraf gedefinieerde indelingen van Word en pas de resulterende List.ListLevels daarvan aan.

Hoe regel ik het getalformaat, zoals “1)” in plaats van “1.”?

Stel ListLevel.NumberFormat op het betreffende niveau in op de gewenste opmaakreeks, naast NumberStyle voor de cijferstijl zelf.


API Reference Samenvatting

Klasse/MethodeBeschrijving
ListEen herbruikbare lijst (nummering/opsomming) definitie
ListCollectionDe verzameling van alle lijsten in een document
ListCollection.Add(listTemplate) / AddCopy(srcList)Maak een lijst aan vanuit een vooraf gedefinieerde template, of kopieer een bestaande
ListFormatPer alinea-referentie naar een List en het huidige niveau
ListFormat.ApplyBulletDefault() / ApplyNumberDefault()Pas de standaard opsommingstekens of nummeropmaak toe op een alinea
ListLevelNummer- of opsommingstekenopmaak voor één niveau van een List
ListLevel.NumberStyle / NumberFormatDe cijferstijl en opmaakstring voor een niveau
ListLabelHet gerenderde label (tekst en waarde) voor een specifiek lijstitem
ListTemplateEnum van de vooraf gedefinieerde lijstformaten van Word

Zie ook

 Nederlands