Lucrul cu liste

O listă dintr-un document Microsoft Word este un set de proprietăți de formatare a listei. Listele pot fi utilizate în documentele dvs. pentru a formata, aranja și sublinia textul. Listele sunt o modalitate excelentă de a organiza datele în documente și facilitează cititorilor să înțeleagă punctele cheie.

Fiecare listă poate avea până la 9 nivelurile și proprietățile de formatare, cum ar fi stilul numărului, valoarea de pornire, liniuța, poziția filei etc. sunt definite separat pentru fiecare nivel.

În Aspose.Words, Lucrul cu liste este reprezentat de modulul Lists. Cu toate acestea, obiectul List aparține întotdeauna colecției ListCollection.

Acest subiect descrie modul de lucru programatic cu liste folosind Aspose.Words.

Crearea listelor prin aplicarea formatării listei

Aspose.Words permite crearea ușoară a listelor prin aplicarea formatării listei. DocumentBuilder oferă proprietatea DocumentBuilder.list_format care returnează un obiect ListFormat. Acest obiect are mai multe metode pentru a începe și a termina o listă și pentru a mări/micșora liniuța. Există două tipuri generale de liste în Microsoft Word: cu marcatori și numerotate.

• Pentru a începe o listă cu marcatori, apelați ListFormat.apply_bullet_default.
• Pentru a începe o listă numerotată, apelați ListFormat.apply_number_default.

Marcatorul sau numărul și formatarea sunt adăugate la paragraful curent și toate paragrafele ulterioare create folosind DocumentBuilder până când ListFormat.remove_numbers este apelat pentru a opri formatarea listei cu marcatori.

În documentele Word, listele pot consta din până la nouă niveluri. Formatarea listei pentru fiecare nivel specifică ce glonț sau număr este utilizat, liniuța stângă, spațiul dintre glonț și text etc. Următoarele metode modifică nivelul listei și aplică proprietățile de formatare ale noului nivel:

• Pentru a mări nivelul listei paragrafului curent cu un nivel, apelați ListFormat.list_indent
• Pentru a reduce nivelul listei paragrafului curent cu un nivel, apelați ListFormat.list_outdent

Metodele modifică nivelul listei și aplică proprietățile de formatare ale noului nivel.

De asemenea, puteți utiliza proprietatea ListFormat.list_level_number pentru a obține sau a seta nivelul listei pentru paragraf. Nivelurile listei sunt numerotate de la 0 la 8.

Exemplul de mai jos arată cum să construiți o listă pe mai multe niveluri.

Specificați formatarea pentru un nivel de listă

Obiectele la nivel de listă sunt create automat atunci când este creată o listă. Utilizați proprietățile și metodele clasei ListLevel pentru a controla formatarea nivelurilor individuale ale unei liste.

Reporniți lista pentru fiecare secțiune

Puteți reporni o listă pentru fiecare secțiune folosind proprietatea is_restart_at_each_section property. Rețineți că această opțiune este acceptată numai în formatele de documente RTF, DOC și DOCX. Această opțiune va fi scrisă în DOCX numai dacă OoxmlCompliance este mai mare decât Ecma376.

Următorul exemplu de cod arată cum să creați o listă și să o reporniți pentru fiecare secțiune: