Listákkal dolgozás
Listákkal való munka
Ez az útmutató bemutatja, hogyan vannak ábrázolva és vezérelve a számozott és felsorolásos listák a Aspose.Words FOSS-ben a .NET számára. A List egy újrahasználható lista definíció, amelyet minden, azt használó bekezdés megoszt, a ListFormat az, ahogyan egy egyedi bekezdés hivatkozik egy listára és annak aktuális szintjére, és a ListLevel tartalmazza a lista egy szintjének tényleges számozási vagy felsorolási formázását.
A Listaobjektum és a ListCollection
List egy lista definíciót képvisel — a számozási szabályokat, amelyeket egy dokumentum több bekezdésre alkalmazhat. List.ListId azonosítja, List.IsMultiLevel jelzi, hogy több szintet definiál-e, és List.ListLevels egy ListLevelCollection-t ad vissza, amely a lista által definiált minden szinthez egy ListLevel-t tartalmaz. List.IsListStyleDefinition és IsListStyleReference megkülönböztetik azt a listát, amely saját formázást határoz meg, egy olyan listától, amely formázást hivatkozik egy kapcsolt Style (amely a List.Style révén érhető el) segítségével. Minden dokumentum listái a Document.Lists útján érhetők el, ami egy ListCollection-t ad vissza: ListCollection.Add(listTemplate) egy új listát hoz létre a Word előre definiált ListTemplate formátumai közül, Add(listStyle) egyet egy Style alapján hoz létre, AddSingleLevelList(listTemplate) egy egyetlen szintű változatot hoz létre, és AddCopy(srcList) egy meglévő listát másol – hasznos, ha azt szeretnéd, hogy a bekezdések önálló számozással rendelkezzenek (újraindítás), ahelyett, hogy ugyanazt a számlálót osztanák meg. ListCollection.GetListByListId(listId) egy adott listát kér le, és Count jelzi, hány lista van a dokumentumban.
Listák alkalmazása bekezdésekhez a ListFormat segítségével
ListFormat, amelyet egy bekezdés formázásából érünk el, szabályozza, hogy melyik listához tartozik a bekezdés és milyen szinten. ListFormat.List a List, amelyet a bekezdés használ, és ListFormat.ListLevelNumber a lista nullától induló szintje; IsListItem jelzi, hogy a bekezdés egyáltalán része-e a listának. ApplyBulletDefault() és ApplyNumberDefault() egy hívásban alkalmazzák a Word alapértelmezett felsorolás vagy számozott lista formázását a bekezdésre, RemoveNumbers() eltávolítja a lista formázását, és ListIndent()/ListOutdent() egy bekezdést mélyebbre vagy sekélyebbre helyeznek a lista szintjeiben — ugyanazok a műveletek, melyeket a Word a Tab vagy Shift+Tab lenyomásakor hajt végre egy lista bekezdésének elején.
Lista szintek és számozási stílus
ListLevel tartalmazza egy lista egy szintjének formázását: NumberStyle (egy NumberStyle enum érték, például arab számok vagy római számok), NumberFormat (a formátum karakterlánc, amely a számot szöveges elemmel kombinálja, például pont vagy zárójel), StartAt (a kezdő szám), és RestartAfterLevel (melyik magasabb szint növelése indítja újra ennek a szintnek a számlálóját). Alignment (egy ListLevelAlignment érték: Left, Center, Right) és TrailingCharacter (egy ListTrailingCharacter érték: Tab, Space, Nothing) szabályozzák, hogy a címke hogyan helyezkedik el és hogyan válik el a bekezdés szövegétől, együtt TabPosition, NumberPosition és TextPosition pontos elrendezéshez. IsLegal jogi stílusú számozást kényszerít (mindig arab, függetlenül a NumberStyle értéktől), és LinkedStyle összekapcsolja a szintet egy bekezdés Style-val. Képes felsorolásnál a CreatePictureBullet() és DeletePictureBullet() egy ImageData bullet képet kezelnek, a ListLevel.Font pedig a szám vagy bullet karakter formázását állítja be. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) kiszámítja a tényleges címkeértéket a számozási sorozat adott pozíciójában.
Lista címkék és előre definiált sablonok
ListLabel leírja egy adott listaelem példányának megjelenített címkéjét — LabelString a Word által megjelenített literális szöveg (például „3.” vagy „•”), LabelValue a mögöttes numerikus érték, és Font a címke formázása. ListTemplate a Word előre definiált listaformátumainak enumja (bullet stílusok, mint BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds, valamint számozott formátumok), amelyet a ListCollection.Add(listTemplate) segítségével lehet használni, hogy egy beépített formátummal induljon, ahelyett, hogy egyes tulajdonságokat építenénk fel.
Tippek és bevált gyakorlatok
- Használja a
ListCollection.AddCopy(srcList)-t, ha egy új bekezdéscsoportnak önállóan kell újrakezdenie a lista számozását, ahelyett, hogy egy már más bekezdésekhez csatoltList-t újrahasználná. - Előnyben részesítse a
ListFormat.ApplyNumberDefault()/ApplyBulletDefault()használatát szabványos listákhoz ahelyett, hogy mindenListLeveltulajdonságot kézzel konfigurálna. - Ellenőrizze a
List.IsListStyleReferenceés aIsListStyleDefinitionközötti különbséget, mielőtt közvetlenül módosítaná a lista formázását — egy stílusra hivatkozó lista formázását esetleg a kapcsolódóStylevezérelheti. - Állítsa be a
RestartAfterLevel-t expliciten a beágyazott listákon, ahelyett, hogy az alapértelmezett újraindulási viselkedésre támaszkodna, amikor a számozást adott vázlat szinteknél újra kell indítani. - Használja a
ListFormat.ListIndent()/ListOutdent()kombinációt a bekezdés listaszintok közötti áthelyezéséhez aListLevelNumberközvetlen beállítása helyett, mivel ezek a módszerek belsőleg konzisztens módon tartják a bekezdés listformázását.
Gyakori problémák
| Probléma | Ok | Javítás |
|---|---|---|
| Két bekezdés, amelynek önállóan kellene számozódnia, ugyanazzal a sorozattal folytatódik | Mindkét bekezdés ListFormat.List értéke ugyanarra a közös List objektumra hivatkozik | Adj a második bekezdésnek saját listát a ListCollection.AddCopy(srcList) használatával, ahelyett, hogy ugyanazt a List használná |
| Az egyedi számozási formátum karakterlánc nem jelenik meg a várt módon | ListLevel.NumberFormat nem felel meg a szint NumberStyle elvárt mintájának | Ellenőrizze, hogy a NumberFormat és NumberStyle konzisztensen legyenek beállítva a szerkesztett szinthez |
| A lista behúzása helytelennek tűnik a szintek programozott módosítása után | A ListLevelNumber közvetlenül lett beállítva a kapcsolódó pozíciótulajdonságok frissítése nélkül | Használja a ListFormat.ListIndent()/ListOutdent() kombinációt a ListLevelNumber közvetlen beállítása helyett |
| A képes felsorolásjel nem jelenik meg | Nem készült képes felsorolásjel a szinthez, vagy az alapértelmezett szöveges felsorolásformázás még aktív | Hívja meg a ListLevel.CreatePictureBullet() függvényt, és adja meg a kép adatokat a szöveges felsorolásformázás eltávolítása előtt |
FAQ
Mi a különbség a List és a ListFormat között?
List a bekezdések között megosztott újrahasználható számozási/jelölő definíció; a ListFormat bekezdésenkénti — arra mutat, hogy egy adott bekezdés melyik List-t használ és melyik szinten, a ListFormat.List és ListLevelNumber segítségével.
Hogyan ellenőrizhetem, hogy egy bekezdés része-e egy listának?
Olvassa el a ListFormat.IsListItem a bekezdés formázásáról; ha true, akkor a ListFormat.List és ListLevelNumber leírja, melyik listához és szinthez tartozik.
Hogyan indíthatok egy új listát az 1-es számozással, függetlenül egy meglévő listától?
Használja a ListCollection.AddCopy(srcList) elemet a lista definíció független másolatának létrehozásához, majd alkalmazza a másolatot az új bekezdésekre — ahelyett, hogy az eredeti List elemet újrahasználná, amely folytatná ugyanazt a számlálót.
Hogyan hozhatok létre egy felsorolást vagy számozott listát teljesen az elejétől?
Használja a ListFormat.ApplyBulletDefault() vagy a ApplyNumberDefault() elemet a Word alapértelmezett formázásához, vagy a ListCollection.Add(listTemplate) elemet egy ListTemplate értékkel, hogy a Word egyik előre definiált formátumából induljon, és onnan testreszabja a kapott List.ListLevels értéket.
Hogyan szabályozhatom a számformátumot, például „1)” helyett „1.”?
Állítsa be a ListLevel.NumberFormat elemet a megfelelő szinten a kívánt formátumkarakterláncra, a NumberStyle elemmel együtt a számsor stílusához.
API Reference Összefoglaló
| Osztály/Módszer | Leírás |
|---|---|
List | Újrahasználható lista (számozás/pontozott) definíció |
ListCollection | A dokumentumban lévő összes lista gyűjteménye |
ListCollection.Add(listTemplate) / AddCopy(srcList) | Készítsen listát egy előre meghatározott sablonból, vagy másoljon egy meglévőt |
ListFormat | Bekezdésenkénti hivatkozás egy List és az aktuális szint |
ListFormat.ApplyBulletDefault() / ApplyNumberDefault() | Alkalmazza az alapértelmezett felsorolás- vagy számozási formázást egy bekezdésre |
ListLevel | Számozási/felsorolási formázás egy List egy szintjéhez |
ListLevel.NumberStyle / NumberFormat | A szint numerikus stílusa és formátumkarakterlánca |
ListLabel | A megjelenített címke (szöveg és érték) egy adott listaelemhez |
ListTemplate | Word előre definiált listaformátumok felsorolása |