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 eenListopnieuw te gebruiken die al aan andere alinea’s gekoppeld is. - Geef de voorkeur aan
ListFormat.ApplyNumberDefault()/ApplyBulletDefault()voor standaardlijsten in plaats van elkeListLeveleigenschap handmatig te configureren. - Controleer
List.IsListStyleReferenceversusIsListStyleDefinitionvoordat je de lijstopmaak direct wijzigt — de opmaak van een stijl-verwijzende lijst kan worden beheerd door de gekoppeldeStyle. - Stel
RestartAfterLevelexpliciet 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 vanListLevelNumberdirect in te stellen, omdat deze methoden de lijstopmaak van de alinea intern consistent houden.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Twee alinea’s die onafhankelijk genummerd moeten worden, blijven dezelfde reeks voortzetten | De ListFormat.List van beide alinea’s verwijst naar hetzelfde gedeelde List object | Geef 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 weergegeven | ListLevel.NumberFormat komt niet overeen met het verwachte patroon voor het NumberStyle van het niveau | Controleer 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 niveaus | ListLevelNumber werd direct ingesteld zonder de gerelateerde positie-eigenschappen bij te werken | Gebruik ListFormat.ListIndent()/ListOutdent() in plaats van ListLevelNumber rechtstreeks in te stellen |
| Er verschijnt geen afbeeldingsteken | Er is geen afbeeldingsteken voor het niveau aangemaakt, of de standaard tekstopmaak voor opsommingstekens is nog actief | Roep 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/Methode | Beschrijving |
|---|---|
List | Een herbruikbare lijst (nummering/opsomming) definitie |
ListCollection | De 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 |
ListFormat | Per alinea-referentie naar een List en het huidige niveau |
ListFormat.ApplyBulletDefault() / ApplyNumberDefault() | Pas de standaard opsommingstekens of nummeropmaak toe op een alinea |
ListLevel | Nummer- of opsommingstekenopmaak voor één niveau van een List |
ListLevel.NumberStyle / NumberFormat | De cijferstijl en opmaakstring voor een niveau |
ListLabel | Het gerenderde label (tekst en waarde) voor een specifiek lijstitem |
ListTemplate | Enum van de vooraf gedefinieerde lijstformaten van Word |