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 csatolt List-t újrahasználná.
  • Előnyben részesítse a ListFormat.ApplyNumberDefault() / ApplyBulletDefault() használatát szabványos listákhoz ahelyett, hogy minden ListLevel tulajdonságot kézzel konfigurálna.
  • Ellenőrizze a List.IsListStyleReference és a IsListStyleDefinition kö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ó Style vezé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 a ListLevelNumber kö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émaOkJavítás
Két bekezdés, amelynek önállóan kellene számozódnia, ugyanazzal a sorozattal folytatódikMindkét bekezdés ListFormat.List értéke ugyanarra a közös List objektumra hivatkozikAdj 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ódonListLevel.NumberFormat nem felel meg a szint NumberStyle elvárt mintájánakEllenő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ánA ListLevelNumber közvetlenül lett beállítva a kapcsolódó pozíciótulajdonságok frissítése nélkülHasználja a ListFormat.ListIndent()/ListOutdent() kombinációt a ListLevelNumber közvetlen beállítása helyett
A képes felsorolásjel nem jelenik megNem készült képes felsorolásjel a szinthez, vagy az alapértelmezett szöveges felsorolásformázás még aktívHí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ódszerLeírás
ListÚjrahasználható lista (számozás/pontozott) definíció
ListCollectionA 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
ListFormatBekezdé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
ListLevelSzámozási/felsorolási formázás egy List egy szintjéhez
ListLevel.NumberStyle / NumberFormatA szint numerikus stílusa és formátumkarakterlánca
ListLabelA megjelenített címke (szöveg és érték) egy adott listaelemhez
ListTemplateWord előre definiált listaformátumok felsorolása

Lásd még:

 Magyar