Колекция Word ListGalleries и обект ListGallery - как да направите списък в word

Добър ден на всички абонати и читатели на блога scriptcoding.ru. Днес ще разгледаме как да направим списък в документ на Word програмно, като използваме колекцията ListGalleries на обектния модел на Word.

Колекцията ListGalleries е отправна точка за създаване на маркиран или номериран списък в Word с помощта на VBA макроси или скриптове на Windows Script Host. По принцип колекцията съхранява обекти СписъкГалерия, които представляват отделен списък, но нито ListGalleries, нито ListGallery съдържат средствата за формиране на списък на Word с желаните параметри. Така че, от практическа страна, имате нужда само от едно свойство и един метод от колекцията и две свойства и един метод.

За достъп до колекцията ListGalleries използвайте свойството със същото име на класа Word.Application. Тъй като този материал е малко объркващ, нека първо разгледаме свойствата и методите на колекцията и класа и едва тогава ще се опитам да покажа и обясня какво е необходимо и за какво ...

ListGalleries - маркирани и номерирани свойства и методи на списъка в Word

Броя - Брой класове на ListGallery в текущата колекция

Артикул (индекс) - Позволява ви достъп до ListGallery от даден тип.

индекс - Определя типа на списъка в Word, съдържа стойността на константата WdListGalleryType:

wdBulletGallery - 1 - Списък с маркирани думи.
wdNumberGallery - 2 - Номериран списък с думи.
wdOutlineNumberGallery - 3 - многостепенен списък.

ListGallery - свойства и методи, номериран и маркиран списък в Word

ListTemplates - Връща ListTemplates, който представлява всички типове списъци в Word за посочения списък в колекцията. Само четене.

Модифициран (индекс) - Връща True, ако са направени промени в дадения шаблон на списъка. Само четене.

Нулиране (индекс) - Позволява ви да изчистите предварително създадения шаблон (индекс - номер на шаблон).

Добре, нека сега да разгледаме как да направим списък на Word и целия процес ....

Всички знаем, че за да направим списък в документ на Word, на първо място, трябва да изберем необходимите параграфи, след това да изберем типовете списъци на Word. Три раздела отговарят за типа:

Маркери - съдържа 7 вида маркери и ви позволява да създадете свой собствен списък с маркери.
Номериране - също така съдържа 7 номерирани опции за списък в Word и ви позволява да създадете свой собствен шаблон.
Многостепенен списък - също избор от 7 готови шаблона и възможност да създадете свой собствен.

Подобни действия се случват, когато трябва програмно да направите списък в Word:

Първо, трябва да осъществим достъп до колекцията ListGalleries чрез свойството със същото име на класа на приложението Word.

След това трябва да влезете в ListGallery - можем да използваме свойството item (вижте по-горе) или да зададем стойността директно:

Моля, обърнете внимание, че прехвърляме не номера на класа, а неговия тип (има три опции).

След като решихме желания тип списък в Word и получихме достъп до ListGallery, трябва да се обърнем към свойството ListTemplates, което ни позволява достъп до колекцията със същото име:

Добре, имаме достъп до колекцията ListTemplates, нека видим за какво служи. Както бе споменато по-горе, има 7 предварително изградени шаблона за всеки от трите типа списъци на Word. Всъщност всеки такъв шаблон е клас ListTemplate, който е част от колекцията. Както при обекта ListGallery, тук ситуацията е същата - предаваме не число, а тип.

ListTemplates - свойства и методи, как да направите списък в Word

Броя - Брой класове на ListTemplate. Само четене.

Добавяне (OutlineNumbered, Name) - Връща ListTemplate, представляващ новия шаблон на списък. И двата параметъра не са задължителни.

КонтурНомериран - Вярно - списъкът ще бъде многостепенен, False - списъкът съдържа само едно ниво на влагане.

Име - име на шаблон.

Артикул (брой) - Получава един обект ListTemplate в колекцията.

ListTemplate - свойства и методи, типове списъци в Word

ListLevels - Връща ListLevels, представляващи всички списъци за посочения ListTemplate.

Име - Получава или задава името на посочения клас. Чети и пиши.

КонтурНомериран - Вярно, ако посоченият ListTemplate е на ниво. Чети и пиши.

Конвертиране (ниво) - Позволява ви да конвертирате списък: многостепенно в едно ниво или обратно.

ниво - Допълнителен параметър, който определя нивото на влагане в списъка с думи. Този аргумент може да бъде число от 1 до 9. Ако този аргумент е пропуснат, тогава стойността 1 е по подразбиране.

Последният етап, който показва как се прави списък в Word, е етапът на избор на ниво на влагане. По принцип трябва да имаме достъп до колекцията ListLevels и обектите ListLevel. Тъй като тази колекция и обект съдържат доста методи и свойства, аз ги описах в отделна статия - „Колекция Word ListLevels и обект ListLevel“. Но за да не ви предоставяме материали без примери, ще направим два списъка в Word, които можем да използваме повторно. Първо ще ви дам примери за кодове и едва след това ще обясня какво и как.