3.2. Объекты word, их свойства и методы.

3.2.1. Модель объектов word

Visual Basic поддерживает набор объектов, соответствующих элементам Microsoft Word 2000. Методы и свойства этих объектов позволяют автоматизировать все операции в Word.

Модель объектов Microsoft Word 2000 включает около 180 объектов. Полную схему модели объектов можно просмотреть в разделе «Microsoft Word Objects» справочной системы. Наиболее быстрый способ получения подробного описания конкретного объекта - щелкнуть по его имени на схеме модели объектов. Однако из всего многообразия объектов Word практически небольшая их часть наиболее часто используема.

Модель наиболее часто используемых объектов и связь между ними показана на рис. 3.2.

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

Рассмотрим наиболее важные классы объектов.

Caracters(Range)

Tables(Table)

Range

Words(Range)

Shapes(Shape)

Sentences(Range)

InlineShapes(InlineShape)

Paragraphs(Paragraph)

Fields(Field)

Sections(Section)

Рис. 3.2.Фрагмент объектной модели Word

3.2.2.Объект Appication

Объект Appication – само приложение MS WORD в целом. Он создается при запуске Word. Через свойства и методы этого объекта можно получить доступ к глобальным параметрам приложения, управлять внешним видом окна Word и обращаться к объектам, занимающим более низкие уровни в модели объектов Word. Объект Application имеет более сотни элементов: свойств, методов и событий.

Как уже говорилось выше, свойства любого объекта делятся на две группы: свойства – участники (объекты) и терминальные свойства (обычные переменные VBA).

Свойство- участник, представляющий собой вложенный объект, возвращает ссылку на данный объект. В объекте Application более 30 коллекций и простых объектов. Среди них наибольший интерес представляют:

Documents(Document) – коллекция документов Word, содержащая все открытые документы;

Templates(Template) – коллекция шаблонов Word, содержащая все открытые шаблоны;

Windows(Window) – коллекция, содержащая все открытые окна;

Selection – объект, задающий выделенную область;

Options – объект, позволяющий программным путем установить параметры приложения и документа.

Среди многообразия методов объекта Application целесообразно выделить те, которые позволяют выполнять операции над приложением в целом: Activate – активизация приложения, Quit – выход из приложения и осуществлять запуск макросов:

Run – запуск макроса и OnTime – запуск макроса в заданное время.

3.2.3. Объект Document

Объект Document представляет собой новый или созданный ранее открытый документ.

При запуске Word создается коллекция открытых документов Documents, содержащая как минимум один объект Document. Создавая новый или открывая ранее созданный файл, в коллекцию добавляется объект Document. Получить доступ к нужному объекту Document коллекции можно выражением:

Documents (index),

Где index – имя файла или номер документа в коллекции объектов Documents.

Через свойства и методы объекта Document и коллекции Documents можно создавать, открывать, активизировать и закрывать документы.

Рассмотрим на примерах некоторые свойства методы, позволяющие выполнять эти операции над документами.

К свойствам объекта Document относятся:

Count – количество открытых в данный момент документов;

ActiveDocument – активный документ.

Пример 3.3:

‘процедура выводит в окно отладки имена всех открытых документов Public Sub pr33() Dim kol As Byte Kol = Documents.Count If kol >= 1 Then For i = 1 To kol: Debug.Print Documents(i).Name: Next Else MsgBox "Нет открытых документов" End If End Sub

Пример 3.4:

‘процедура выводит в диалоговое окно имя активного документа Public Sub pr34() If Documents.Count >= 1 Then MsgBox ActiveDocument.Name Else MsgBox "Нет открытых документов" End If End Sub

Основные методы объекта Document и коллекции Documents:

Open – открывает файл, содержащий существующий документ и автоматически добавляет его в коллекцию;

Add – добавляет новый пустой документ;

Save – сохраняет изменения в существующем документе без закрытия;

SaveAs (только для объекта) – сохраняет активный вновь созданный документ в текущей папке;

Item – позволяет получить доступ к элементу коллекции;

Activate (только для объекта) – активизирует открытый документ;

PrintOut (только для объекта) – печать документа;

Close – закрывает документ.

Пример 3.5

‘процедура, используя метод Open, возвращает объект Document, ‘представляющий только что открытый документ Metvba.doc, выводит ‘его имя и закрывает Public sub pr35() Set mydoc = _ Documents.Open(FileName:="d:\Met_mat\му_0719\Metvba.doc") MsgBox mydoc.Name Mydoc.Close End Sub

Пример 3.6:

‘Процедура перебирает коллекцию Documents в поисках документа ‘Metvba.doc. Если он уже открыт, то активизирует его, в ‘противном случае – открывает Public sub pr36() For Each mydoc In Documents If InStr(1, mydoc.Name, "Metvba.doc") Then mydoc.Activate w = True Exit For Else w = False End If Next mydoc If w = False Then Documents.Open FileName:="d:\Met_mat\му_0719\Metvba.doc" End If End Sub

Пример 3.7:

‘процедура после вывода имен открытых документов закрывает их Public Sub pr37() If Documents.Count >= 1 Then For i = 1 To Documents.Count: Debug.Print Documents(i).Name: Next Documents.Close End If End Sub

Пример 3.8:

‘Процедура закрывает документ Metvba.doc без сохранения Public pr38() Documents(“Metvba.doc “).Close SaveChanges:=wdDoNoSaveChanges End Sub

Документ Word организован довольно сложно. Текст документа может быть дополнен таблицами, рисунками, документ может содержать колонтитулы, сноски, ссылки и т.д. Свойства-участники объекта Document позволяют получить доступ к 44 вложенным объектам, большинство из которых являются коллекциями. Рассмотрим некоторые из них, объединив объекты в группы.