Коллекция Word Sections и объекты Section — Разделы документа

Коллекция Word Sections и объекты Section — Разделы документа Объектная модель Microsoft Word

В этой статье мы рассмотрим коллекцию Sections и ее объекты Section, которые предоставляют разделы документа Word. Существует тонкая грань между разделами и страницами документа, так, в созданном документе существует только один раздел, при желании можно добавить еще несколько, однако количество страниц может быть или равным количеству разделов, или больше. Добавление разделов документа Word актуально в том случае, если мы хотим оформить рамку для каждой страницы в индивидуальном стиле.

Возьмем такой пример: в документе 20 страниц и один раздел, которому они принадлежат, приложение Word позволяет применить заданную рамку ко всему разделу, к первой странице раздела или ко всем страницам кроме первой. Но, что если мы хотим, что бы каждая страница была оформлена индивидуальной рамкой (свет, стиль, толщина линии)? В таком случае, нам придется добавить 20 отдельных разделов в документ Word, и уже для каждого применить индивидуальное оформление.

Sections – разделы документа Word

Коллекция Sections содержит объекты Section для заданного документа, выделения или выбора. Отсюда следует, что мы можем получить доступ к данной коллекции тремя способами с помощью свойства Sections, которое есть у таких объектов:

Word Document – В данном случаем мы обрабатываем разделы для конкретного документа Word.

Word Selection – Тут мы можем получить те разделы документа Word, которое принадлежат заданному выделению.

Word Range – Тут мы можем получить те разделы документа Word, которое принадлежат заданному выбору.

Свойства

Count – Возвращает количество разделов (объектов Section) в коллекции.

First — Возвращает объект Section, представляющий первый элемент в коллекции Sections.

Last — Возвращает объект Section, представляющий последний элемент в коллекции Sections.

PageSetup — Возвращает объект PageSetup.

Методы

Add(Range, Start) — Возвращает объект Section, представляющий новый раздел, добавленный в документ Word. Оба параметра являются дополнительными.

Range — Диапазон перед которым нужно вставить раздел. Если этот аргумент опущен, раздел документа Word вставляется в конец.

Start — Тип раздела документа Word, который вы хотите добавить. Если параметр отсутствует, то раздел добавляется после следующей страницы. Значение константы WdSectionStart.

  • wdSectionContinuous — 0 – Сплошной раздел.
  • wdSectionEvenPage — 3 — Четные страницы.
  • wdSectionNewColumn — 1 – Колонка.
  • wdSectionNewPage — 2 — Страница.
  • wdSectionOddPage — 4 — Нечетные страницы.

Item(index) – Доступ к заданному разделу по его номеру в коллекции.

Добавление новых разделов Word

Section – разделы документа Word

Свойства

Application — Возвращает объект Word Application.

Borders — Возвращает коллекцию Borders.

Footers и Headers — Свойства возвращают коллекцию HeadersFooters для нижнего или верхнего колонтитула.

Range — Возвращает объект Range.

PageSetup— Возвращает объект PageSetup.

Index — Возвращает позицию объекта Section в коллекции.

Теперь рассмотрим два программных кода на языке VBScript и JScript:

' ----------------------------------------------------------------------------' Коллекция Sections и объект Section' Добавление разделов в документ Word' Sections.vbs' ----------------------------------------------------------------------------OptionExplicit dim oWord, oDoc, oSel, i, MyText Set oWord = CreateObject("Word.Application")Set oDoc = oWord.DocumentsoDoc.Add()oWord.Visible = TrueSet oSel = oWord.Selection MyText = "Разделы документа Word. " For i=0 to 40    oSel.TypeText MyText & MyText & MyText & MyText & MyText & MyText & MyText    oSel.TypeParagraph Next MsgBox "Количество разделов в документе Word - " & oDoc(1).Sections.Count oDoc(1).Sections.AddoDoc(1).Sections.AddoDoc(1).Sections.Add MsgBox "Количество разделов в документе Word - " & oDoc(1).Sections.Count
// ----------------------------------------------------------------------------// Коллекция Sections и объект Section// Добавление разделов в документ Word// Sections.js// ----------------------------------------------------------------------------var oWord, oDoc, oSel, i, MyText; oWord = WScript.CreateObject("Word.Application");oDoc = oWord.Documents;oDoc.Add();oWord.Visible=trueoSel = oWord.Selection; MyText ="Разделы документа Word. "; for(i=0; i<=40; i++){    oSel.TypeText(MyText + MyText + MyText + MyText + MyText + MyText + MyText);    oSel.TypeParagraph();} WScript.Echo("Количество разделов в документе Word - "+ oDoc(1).Sections.Count); oDoc(1).Sections.Add();oDoc(1).Sections.Add();oDoc(1).Sections.Add(); WScript.Echo("Количество разделов в документе Word - "+ oDoc(1).Sections.Count);

В данных примерах все довольно просто. В самом начале мы создаем ссылку на объект Word Application, далее происходит создание нового документа и вставка в него заданного текста. Приложение Word автоматически создает один раздел для всего документа, плюс, данный раздел будет содержать в себе все страницы.

Далее в сценарии происходит вывод количества разделов документа Word, естественно, их значение равно 1. После, мы добавляем три новых раздела с помощью метода Add и снова выводим общее количество разделов.

Оцените статью
Технологии программирования и ведение блога
Добавить комментарий