Колекція Word ListGalleries та об’єкт ListGallery - як зробити список у word

Доброго часу доби всім передплатникам та читачам блогу scriptcoding.ru. Сьогодні ми розглянемо, як зробити список у Word документі програмним шляхом за допомогою колекції ListGalleries об'єктної моделі Word.

Колекція ListGalleries є відправною точкою, щоб зробити маркований або нумерований список Word за допомогою макросів VBA, або сценаріїв сервера Windows Script Host. По суті, колекція зберігає об'єктиListGallery, які представляють індивідуальний список, але ні ListGalleries і ListGallery не містять засобів для формування списку Word з потрібними параметрами. Так, з практичного боку вам знадобиться тільки одна властивість та один метод із колекції та дві властивості та один метод.

Для доступу до колекції ListGalleries використовується однойменна властивість класу Word.Application. Так як даний матеріал трохи заплутаний, то давайте для початку розглянемо властивості та методу колекції та класу, а вже потім я постараюся показати та пояснити, що і для чого потрібно…

ListGalleries – властивості та методи, маркований та нумерований список у Word

Count – Кількість класів ListGallery у поточній колекції

Item (index) – Дозволяє отримати доступ до ListGallery заданого типу.

index – Визначає тип списку Word, містить значення константи WdListGalleryType:

• wdBulletGallery - 1 - маркований список Word.
• wdNumberGallery – 2 – нумерований список Word.
• wdOutlineNumberGallery - 3 - багаторівневий список.

ListGallery – властивості та методи, нумерований та маркований список у Word

ListTemplates - Повертає ListTemplates, яка представляє всі типи списків Word для зазначеного списку вколекції. Лише читання.

Modified (index) – Поверне значення True, якщо відбувалися зміни у заданому шаблоні списку. Лише читання.

Reset (index) – Дозволяє очистити створений раніше шаблон (index – номер шаблону).

Добре, тепер розглянемо, як зробити список Word, і весь процес….

Всі ми знаємо, щоб зробити список у документі Word, насамперед треба вибрати потрібні абзаци, після цього ми вибираємо типи списків Word. За тип відповідають три вкладки:

• Маркери – містить 7 типів маркерів та дозволяє створити власний список-маркер.
• Нумерація – також містить 7 варіантів нумерованого списку Word і дає можливість створити власний шаблон.
• Багаторівневий список – також на вибір дається 7 готових шаблонів та можливість сформувати власний.

Аналогічні дії відбуваються, і тоді, коли треба програмно зробити список у Word:

Спочатку нам потрібно отримати доступ до колекції ListGalleries через однойменну властивість класу Word Application.

Далі потрібно отримати доступ до ListGallery – ми можемо або використати властивість item (дивіться вище) або задати значення безпосередньо:

Зверніть увагу, що ми передаємо не номер класу, а його тип (всього три варіанти).

Після того, як ми визначилися з потрібним типом списку Word і отримали доступ до ListGallery, нам потрібно звернутися до властивості ListTemplates, яка дозволяє отримати доступ до однойменної колекції:

Добре ми отримали доступ до колекції ListTemplates, розглянемо, для чого вона потрібна. Як згадувалося, для кожного з трьох типів списків Word є 7 заготовлених шаблонів. Фактично, кожен такий шаблон є класом ListTemplate, що входить досклад колекції. Як і з об'єктом ListGallery, тут та сама ситуація – ми передаємо не номер, а тип.

ListTemplates – властивості та методи, як зробити список у Word

Count - Кількість класів ListTemplate. Лише читання.

Add (OutlineNumbered, Name) - Повертає ListTemplate, що представляє новий шаблон списку. Обидва параметри є додатковими.

OutlineNumbered – True - список буде багаторівневим, False - список містить лише один рівень вкладеності.

Name – ім'я шаблону.

Item (count) - Повертає окремий об'єкт ListTemplate у колекції.

ListTemplate – властивості та методи, типи списків у Word

ListLevels - Повертає ListLevels, що представляє всі списки для зазначеного ListTemplate.

Name - Повертає або вказує ім'я вказаного класу. Читання та запис.

OutlineNumbered - Значення true, якщо вказаний ListTemplate є багаторівневим. Читання та запис.

Convert (level) – Дозволяє конвертувати список: багаторівневий в однорівневий, або навпаки.

level – Додатковий параметр, який визначає рівень вкладеності списку Word. Цей аргумент може бути числом від 1 до 9. Якщо цей аргумент опущений, то значення 1 - значення за замовчуванням.

Останній етап, який показує як зробити список у Word – етап вибору рівня вкладеності. По суті, нам потрібно отримати доступ до колекції ListLevels та об'єктів ListLevel. Так як дана колекція та об'єкт містять досить багато методів та властивостей, то я описав їх в окремій статті – "Колекція Word ListLevels та об'єкт ListLevel". Але, щоб не надавати вам матеріал без прикладів, ми зробимо два списки Word, які зможемо багаторазововикористовувати. Я спочатку наведу приклади коду, а вже потім поясню, що і як.

---