Lucrul cu listele

Prezentare generală

Acest ghid arată cum sunt reprezentate și controlate listele numerotate și cu marcatori în Aspose.Words FOSS pentru .NET. Un List este o definiție reutilizabilă a listei partajată de fiecare paragraf care o folosește, ListFormat este modul în care un paragraf individual face referire la o listă și nivelul său curent, iar ListLevel conține formatarea efectivă de numerotare sau marcator pentru un nivel al unei liste.


Obiectul Listă și ListCollection

List reprezintă o definiție de listă — regulile de numerotare pe care un document le poate aplica la mai multe paragrafe. List.ListId o identifică, List.IsMultiLevel indică dacă definește mai mult de un nivel, iar List.ListLevels returnează un ListLevelCollection care conține un ListLevel pentru fiecare nivel definit de listă. List.IsListStyleDefinition și IsListStyleReference diferențiază o listă care își definește propria formatare de una care face referire la formatare printr-un Style legat (disponibil prin List.Style). Listele fiecărui document sunt accesate prin Document.Lists, care returnează un ListCollection: ListCollection.Add(listTemplate) creează o listă nouă dintr-unul dintre formatele ListTemplate predefinite ale Word, Add(listStyle) creează una dintr-un Style, AddSingleLevelList(listTemplate) creează o variantă cu nivel unic, și AddCopy(srcList) duplică o listă existentă — util atunci când doriți ca paragrafele să aibă numerotare independentă (o repornire nouă) în loc să împărtășească același contor. ListCollection.GetListByListId(listId) recuperează o listă specifică, iar Count raportează câte liste are documentul.

Aplicarea listelor la paragrafe cu ListFormat

ListFormat, accesat prin formatarea unui paragraf, controlează la ce listă aparține un paragraf și la ce nivel. ListFormat.List este List utilizat de paragraf, iar ListFormat.ListLevelNumber este nivelul zero-bazat în cadrul acelei liste; IsListItem indică dacă paragraful face parte dintr-o listă. ApplyBulletDefault() și ApplyNumberDefault() aplică formatarea implicită a marcatorului sau a listei numerotate din Word unui paragraf printr-un singur apel, RemoveNumbers() elimină formatarea listei, iar ListIndent()/ListOutdent() mută un paragraf mai adânc în nivelurile listei sau îl scoate la un nivel superior — aceleași operații pe care le efectuează Word când se apasă Tab sau Shift+Tab la începutul unui paragraf de listă.

Nivelurile listei și stilul de numerotare

ListLevel conține formatarea pentru un nivel al unei liste: NumberStyle (o valoare enum NumberStyle precum numere arabe sau romane), NumberFormat (șirul de format care combină numărul cu text literal, cum ar fi un punct sau o paranteză), StartAt (numărul de pornire), și RestartAfterLevel (care nivel superior reia incrementarea pentru a reporni contorul acestui nivel). Alignment (o valoare ListLevelAlignment: Left, Center, Right) și TrailingCharacter (o valoare ListTrailingCharacter: Tab, Space, Nothing) controlează poziționarea etichetei și separarea ei de textul paragrafului, alături de TabPosition, NumberPosition și TextPosition pentru un aranjament precis. IsLegal impune numerotarea în stil juridic (întotdeauna arabă, indiferent de NumberStyle), și LinkedStyle asociază nivelul cu un Style de paragraf. Pentru marcatori imagine, CreatePictureBullet() și DeletePictureBullet() gestionează o imagine de marcator ImageData, iar ListLevel.Font stabilește formatarea numărului sau a caracterului marcator. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) calculează valoarea reală a etichetei la o poziție dată în secvența de numerotare.

Etichete de listă și șabloane predefinite

ListLabel descrie eticheta redată pentru o anumită instanță de element de listă — LabelString este textul literal afișat de Word (de exemplu „3.” sau „•”), LabelValue este valoarea numerică de bază, iar Font este formatarea etichetei. ListTemplate este un enum al formatelor de listă predefinite în Word (stiluri de marcatori precum BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds și formate numerotate), utilizat cu ListCollection.Add(listTemplate) pentru a porni de la un format încorporat în loc de a construi fiecare proprietate în parte.


Sfaturi și practici recomandate

  • Utilizaţi ListCollection.AddCopy(srcList) când un nou grup de paragrafe are nevoie de numerotare a listei care porneşte de la zero independent, în loc de a reutiliza un List deja atașat altor paragrafe.
  • Preferaţi ListFormat.ApplyNumberDefault() / ApplyBulletDefault() pentru liste standard în loc de a configura manual fiecare proprietate ListLevel.
  • Verificaţi List.IsListStyleReference faţă de IsListStyleDefinition înainte de a modifica direct formatarea listei — formatarea unei liste care face referire la un stil poate fi controlată de Style asociat în schimb.
  • Stabiliţi RestartAfterLevel explicit pe listele imbricate în loc de a vă baza pe comportamentul implicit de repornire atunci când numerotarea trebuie resetată la niveluri de schiță specifice.
  • Folosește ListFormat.ListIndent()/ListOutdent() pentru a muta un paragraf între nivelurile listei, în loc de a seta ListLevelNumber direct, deoarece aceste metode mențin formatul listei paragrafului coerent intern.

Probleme comune

ProblemăCauzăRemediere
Două paragrafe care ar trebui să fie numerotate independent continuă aceeași secvență„ListFormat.List” al ambelor paragrafe se referă la același obiect List partajatAtribuiți celui de-al doilea paragraf propria listă prin ListCollection.AddCopy(srcList) în loc să reutilizați același List
Un șir de format de numerotare personalizat nu se afișează așa cum era de așteptat„ListLevel.NumberFormat” nu se potrivește cu modelul așteptat pentru nivelul NumberStyleVerificați că NumberFormat și NumberStyle sunt setate în mod coerent pentru nivelul care este editat
Indentarea listei pare incorectă după ce nivelurile au fost modificate programaticListLevelNumber a fost setat direct fără a actualiza proprietățile de poziție aferenteUtilizați ListFormat.ListIndent()/ListOutdent() în loc de a seta ListLevelNumber direct
Un marcator cu imagine nu apareNu a fost creat niciun marcator cu imagine pentru nivel, sau formatarea implicită a marcatorului de text este încă activăApelați ListLevel.CreatePictureBullet() și furnizați datele imaginii înainte de a elimina formatarea marcatorului de text

FAQ

Care este diferența dintre List și ListFormat?

List este definiția reutilizabilă de numerotare/bulă partajată între paragrafe; ListFormat este specific fiecărui paragraf — indică care List folosește un paragraf anume și la ce nivel, prin ListFormat.List și ListLevelNumber.

Cum pot verifica dacă un paragraf face parte dintr-o listă?

Citește ListFormat.IsListItem privind formatul paragrafului; dacă true, ListFormat.List și ListLevelNumber descriu lista și nivelul căruia îi aparține.

Cum pot face ca o listă nouă să înceapă numerotarea de la 1, independent de o listă existentă?

Utilizează ListCollection.AddCopy(srcList) pentru a crea o copie independentă a definiției listei, apoi aplică copia la noile paragrafe — în loc să reutilizezi List original, ceea ce ar continua același contor.

Cum pot crea o listă cu marcatori sau numerotată de la zero?

Folosește ListFormat.ApplyBulletDefault() sau ApplyNumberDefault() pentru formatarea implicită a Word-ului, sau ListCollection.Add(listTemplate) cu o valoare ListTemplate pentru a porni de la unul dintre formatele predefinite ale Word-ului și a personaliza apoi List.ListLevels rezultat.

Cum pot controla formatul numerelor, de exemplu „1)” în loc de „1.”?

Setează ListLevel.NumberFormat la nivelul relevant la șirul de format dorit, împreună cu NumberStyle pentru stilul numeral propriu-zis.


API Reference Rezumat

Clasă/MetodăDescriere:
ListO definiție reutilizabilă de listă (numerotare/ marcator)
ListCollectionColecția tuturor listelor dintr-un document
ListCollection.Add(listTemplate) / AddCopy(srcList)Creează o listă dintr-un șablon predefinit sau copiază una existentă
ListFormatReferință per-paragraf la un List și nivelul curent
ListFormat.ApplyBulletDefault() / ApplyNumberDefault()Aplică formatarea implicită cu marcatori sau numerotare unui paragraf
ListLevelFormatare de numerotare/marcatori pentru un nivel al unui List
ListLevel.NumberStyle / NumberFormatStilul numeric și șirul de format pentru un nivel
ListLabelEticheta redată (text și valoare) pentru un element specific al listei
ListTemplateEnum al formatelor de listă predefinite din Word

Vezi și:

 Română