Colecția Word ListGalleries și obiectul ListGallery - cum să faci o listă în Word

O zi bună tuturor abonaților și cititorilor blogului scriptcoding.ru. Astăzi ne vom uita la cum să facem o listă într-un document Word în mod programatic, folosind colecția ListGalleries a modelului obiect Word.

Colecția ListGalleries este punctul de plecare pentru a crea o listă cu marcatori sau numerotate în Word folosind macrocomenzi VBA sau scripturi de server Windows Script Host. De fapt, colecția stochează obiecteListGallery care reprezintă o listă individuală, dar nici ListGalleries, nici ListGallery nu conțin mijloacele pentru a forma o listă de cuvinte cu parametrii doriti. Deci, în termeni practici, aveți nevoie doar de o proprietate și o metodă din colecție și de două proprietăți și o metodă.

Pentru a accesa colecția ListGalleries, utilizați proprietatea clasei Word.Application cu același nume. Deoarece acest material este puțin confuz, să ne uităm mai întâi la proprietățile și metodele colecției și clasei și abia apoi voi încerca să arăt și să explic ce este necesar și de ce ...

ListGalleries - proprietăți și metode, listă cu marcatori și numerotate în Word

Număr - Numărul de clase ListGallery din colecția curentă

Articol (index) - Vă permite să accesați ListGallery de tipul dat.

index - Definește tipul de listă în Word, conține valoarea constantei WdListGalleryType:

• wdBulletGallery - 1 - lista cu marcatori a Word.
• wdNumberGallery - 2 - Lista cu numere de cuvinte.
• wdOutlineNumberGallery - 3 - listă pe mai multe niveluri.

ListGallery - proprietăți și metode, listă numerotată și cu marcatori în Word

ListTemplates - Returnează un ListTemplates care reprezintă toate tipurile de liste din Word pentru lista specificată încolecții. Doar lectură.

Modificat (index) - Returnează True dacă au existat modificări la șablonul de listă dat. Doar lectură.

Resetare (index) – Vă permite să ștergeți șablonul creat anterior (indexul este numărul șablonului).

Bine, acum să vedem cum să facem o listă de cuvinte și întregul proces...

Știm cu toții că pentru a face o listă într-un document Word, în primul rând trebuie să selectăm paragrafele necesare, după care selectăm tipurile de liste Word. Trei file sunt responsabile pentru tip:

• Marcatori – conține 7 tipuri de marcatori și vă permite să vă creați propria listă de marcatori.
• Numerotare - conține, de asemenea, 7 opțiuni pentru o listă numerotată în Word și vă permite să vă creați propriul șablon.
• Lista pe mai multe niveluri – aveți, de asemenea, 7 șabloane gata făcute din care să alegeți și posibilitatea de a vă crea propriile modele.

Acțiuni similare apar atunci când trebuie să creați programatic o listă în Word:

În primul rând, trebuie să accesăm colecția ListGalleries prin proprietatea clasei Word Application cu același nume.

Apoi, trebuie să accesăm ListGallery - putem fie să folosim proprietatea elementului (vezi mai sus), fie să setăm valoarea direct:

Vă rugăm să rețineți că nu trecem numărul clasei, ci tipul acesteia (există trei opțiuni în total).

După ce ne-am decis asupra tipului de listă dorit în Word și am obținut acces la ListGallery, trebuie să ne întoarcem la proprietatea ListTemplates, care vă permite să accesați colecția cu același nume:

Bine, avem acces la colecția ListTemplates, haideți să vedem pentru ce este. După cum am menționat mai sus, există 7 șabloane prestabilite pentru fiecare dintre cele trei tipuri de liste de cuvinte. De fapt, fiecare astfel de șablon este o clasă ListTemplate inclusă încomponenţa colecţiei. Ca și în cazul obiectului ListGallery, situația este aceeași aici - nu trecem un număr, ci un tip.

ListTemplates - proprietăți și metode, cum se face o listă în Word

Count - Numărul de clase ListTemplate. Doar lectură.

Add (OutlineNumbered, Name) - Returnează un ListTemplate care reprezintă noul șablon de listă. Ambele opțiuni sunt opționale.

OutlineNumbered – Adevărat – lista va fi pe mai multe niveluri, Fals – lista conține un singur nivel de imbricare.

Nume este numele șablonului.

Element (număr) - Returnează un obiect ListTemplate individual din colecție.

ListTemplate - Proprietăți și metode, Tipuri de listă în Word

ListLevels - Returnează un ListLevels care reprezintă toate listele pentru ListTemplate specificat.

Nume - Obține sau setează numele clasei specificate. Citire si scriere.

OutlineNumbered - Adevărat dacă ListTemplate specificat este un ListTemplate inline. Citire si scriere.

Convertire (nivel) - Vă permite să convertiți o listă: cu mai multe niveluri în un singur nivel sau invers.

level – Un parametru suplimentar care setează nivelul de imbricare al listei de cuvinte. Acest argument poate fi un număr între 1 și 9. Dacă acest argument este omis, valoarea 1 este valoarea implicită.

Ultimul pas, care arată cum se face o listă în Word, este pasul de selectare a nivelului de imbricare. În esență, trebuie să accesăm colecția ListLevels și obiectele ListLevel. Deoarece această colecție și obiect conțin destul de multe metode și proprietăți, le-am descris într-un articol separat - „Colecția Word ListLevels și obiectul ListLevel”. Dar, pentru a nu vă pune la dispoziție material fără exemple, vom face două liste în Word pe care le putem în mod repetatutilizare. Vă voi da mai întâi exemple de cod și abia apoi vă voi explica ce și cum.

---