2.2. Автоматизация операций с использованием объектов

Чтобы автоматизировать операцию в Microsoft Excel, следует сначала получить ссылку на объект с соответствующими содержимым и функциональностью, а затем воспользоваться его свойствами и методами.

2.2.1. Получение ссылки на объект

Прежде чем делать что-то с объектом, необходимо получить ссылку на него. Для этого необходимо составить выражение, которое обеспечивает доступ к этому объекту; при этом ссылку на очередной объект в иерархии можно получить через соответствующие свойства или методы – аксессоры объектов (object accessors), или просто аксесоры. При построении выражения для доступа к объекту с помощью аксессоров следует иметь в виду:

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

• чтобы после этого перейти к необходимому объекту, нужно последовательно пройти все «вышестоящие» объекты, получая ссылку на очередной объект с помощью аксессоров. Например, свойство Documents объекта Application в Word возвращает объект-набор Documents, представляющий все открытые документы;

• существует другой вид аксессоров – сокращенный; они обеспечивают прямой доступ к объектам модели, не требуя «спуска» от объекта Application. К таким объектам относятся свойства Documents, Workbooks и Presentations, которые позволяют напрямую получить ссылку на набор документов данного приложения. Поэтому для открытия в Word документа MyDoc.doc можно использовать любое из выражений:

Application.Documents.Open FileName := “C:\DOCS\MYDOC.DOC”

Documents.Open FileName := “C:\DOCS\MYDOC.DOC”

Есть и другие сокращенные аксессоры, например, свойства ActiveWindow, ActiveDocument, ActiveWorsheet или ActiveCell, которые возвращают ссылку на какой-либо активный элемент приложения. Например, оператор, приведенный ниже, закрывает активный документ Word. Здесь не упоминаются ни объект Application, ни объект-набор Documents:

ActiveDocument.Close

В качестве сокращенных можно использовать любые аксессоры, содержащиеся в списке Members Of (Компонент) окна Object Browser (Просмотр объектов), когда в списке Classes (Классы) выбрана строка <global> (<глобальные>). Иначе говоря, перед их применением не нужно получать ссылку на объект, к которому они относятся, - Visual Basic определяет это сам по текущему контексту выполнения кода;

• многие объекты – рабочие книги, рабочие листы, документы, презентации, слайды – являются элементами наборов. Поскольку набор всегда стоит в иерархии на один уровень выше находящихся в нем объектов, то обычно, чтобы получить доступ к элементу набора, следует сначала получить ссылку на набор. Имя аксессора, возвращающего ссылку на объект-набор, часто совпадает с именем набора;

• чтобы получить ссылку на отдельный элемент набора, обычно используют свойство или метод Item, которому передают имя или порядковый номер данного элемента. Свойство или метод Item в большинстве наборов применяется по умолчанию;

• переход к объекту, стоящему в иерархии на ступеньку выше, зачастую возможен через свойство Parent текущего объекта. Но оно не всегда возвращает ссылку на прямого предка объекта – иногда можно получить ссылку на его «прапредка» (особенно, если этот объект входит в какой-нибудь набор). Иными словами, свойство Parent объекта из набора может возвращать ссылку на предка набора, а не на сам набор. Например, свойство Parent объекта Document в Word возвращает ссылку на объект Application, а не на набор Documents. Чтобы определить тип объекта, ссылку на который возвращает свойство Parent, необходимо вызвать функцию TypeName. Например, в Microsoft Excel следующий оператор сообщает тип объекта, возвращаемого свойством Parent объекта Worksheet:

MsgBox TypeName(Workbook(1).Worksheets(1).Parent)

Функция TypeName позволяет определять тип объекта, полученного в любом выражении, а не только в тех, где используется свойство Parent;

• для перехода от какого-либо объекта к объекту Application, стоящему на вершине иерархии, часто используется свойство Application. Оно особенно полезно, если необходимо добраться до объектов приложения, в котором был создан внедренный объект. Например, в Power Point следующее выражение возвращает ссылку на объект Application того приложения, в котором создан OLE-объект, размещенный в третьей фигуре (shape) первого слайда текущей презентации:

ActivePresentation.Slides(1).Shapes(3).Object.Application

2.2.2. Вызов свойств и методов объекта

Получив ссылку на нужный объект, можно установить атрибуты этого объекта или выполнить над ним какие-то операции, используя его свойства и методы. При этом точка (.) отделяет выражение, возвращающее ссылку на объект, от имени свойства или метода объекта. Следующий оператор – он будет работать в Microsoft Excel, Word и Power Point – устанавливает левый край активного окна через свойство Left объекта Window, ссылку на который возвращает свойство ActiveWindow:

ActiveWindow.Left = 200

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

ActiveDocument.PrintOut From := “3”, To := “7”

Чтобы добраться до нужных данных приложения (значения в ячейке рабочего листа Microsoft Excel или текста в документе Word), необходимо пройти несколько уровней модели объектов. В примере для Word, приведенном ниже, для перехода от объекта верхнего уровня к тексту документа используются такие свойства и методы:

• свойство Application – возвращает ссылку на объект Application;

• свойство Documents объекта Application – возвращает ссылку на набор Documents;

• метод Item набора Documents – возвращает ссылку на отдельный объект Document;

• свойство Words объекта Document – возвращает ссылку на набор Words;

• свойство Item набора Words – возвращает ссылку на отдельный объект Range;

• свойство Text объекта Range – записывает текст как первое слово в документе.

Application.Documents.Item(1).Words.Item(1).Text = “The”

Поскольку свойство Documents глобальное, его можно использовать без указания Application, а так как Item – свойство или метод по умолчанию для объектов-наборов, его можно не упоминать в тексте программы. Следовательно, предыдущий оператор можно записать иначе, и при этом новый оператор будет неявно делать то же, что предыдущий – явно:

Documents(1).Words(1).Text = “The”

2.2.3. Инструментальные средства Visual Basic

В большинстве случаев определить нужный объект, свойство или метод достаточно сложно, но в приложениях Office предусмотрен ряд инструментальных средств, которые могут помочь при формировании программы для выполнения необходимых операторов. К таким инструментальным средствам можно отнести запись макроса. Данная операция транслирует последовательность действий с пользовательским интерфейсом в набор инструкций Visual Basic. Хотя полученный таким образом код дает представление о необходимых свойствах или методах, все же не стоит его использовать без редактирования, так как код, генерируемый при записи макроса, не слишком эффективен и надежен. Часто код, полученный при записи макроса, работает корректно лишь в том случае, если выделен или активизирован определенный объект. Код будет надежнее и гибче, если проход по модели объектов в нем не начинается с выделенного или активизированного объекта. Чтобы улучшить записанный код, можно воспользоваться справочной системой Visual Basic для любого приложения Office, которая содержит разделы по каждому объекту, свойству, методу и событию в модели объектов. Для того, чтобы по имени объекта определить его содержимое и функциональность, необходимо его активизировать и открыть раздел справочной системы с подробной информацией о нем. Разделы справочной системы, посвященные конкретным объектам, содержат:

• схему (в верхней части раздела), отражающую наиболее значимые объекты, расположенные непосредственно выше и ниже данного объекта в иерархии (модели объектов). Активизировав любой объект на схеме, можно получить подробную информацию о нем;

• описание содержимого и функциональных возможностей объекта;

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

• гипертекстовые ссылки в верхней части раздела, с помощью которых можно открывать списки свойств и методов объекта.

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

У каждого приложения office есть файл – библиотека объектов или библиотека типов; в нем содержится информация об объектах, свойствах, методах, событиях и встроенных константах, предоставляемых данным приложением. Для просмотра содержимого файла и описываемой им модели объектов можно использовать средство просмотра объектов – Object Browser. Для просмотра полного списка объектов из всех библиотек, на которые есть ссылки, предусмотрена строка верхнего списка <All Libraries> (<Все библиотеки>), а для просмотра объектов из отдельной библиотеки следует выбрать в том же списке строку, содержащую название соответствующего приложения. Если такая библиотека отсутствует в списке, необходимо создать ссылку на нее в диалоговом окне References (Ссылки), которое открывается одноименной командой из меню Tools (Сервис).

В списке Classes (Классы) отображаются имена объектов и перечислимых типов из всех библиотек, на которые есть ссылки. Класс – это тип, или описание объекта, а объект – фактический экземпляр класса. Активизировав имя объекта в списке Classes (Классы), в списке Members Of (Компонент) отображаются все свойства, методы и события, связанные с данным объектом. Событие – это действие, распознаваемое объектом, например, щелчок мыши или нажатие клавиши. Активизировав имя свойства или метода в списке Members Of (Компонент), можно получить справку по выделенному ключевому слову с помощью кнопки F1 или в нижней секции окна Object Browser (Просмотр объектов), в которой сообщается синтаксис, тип свойства («только чтение» или «чтение/запись»), имя библиотеки, к которой относится объект, и тип данных, возвращаемых свойством или методом. Если какое-то слово в нижней секции выделено зеленым цветом и подчеркнуто, значит это ссылка, с помощью которой можно получить более подробную информацию. Ссылки позволяют выяснить, как добраться до того или иного объекта. Нижняя секция полезна и тех случаях, когда неизвестен точный синтаксис – имена и порядок аргументов – данного свойства или метода, а также какие аргументы необязательны.

При наличии ссылок на несколько библиотек, содержащих определенные объекты, в диалоговом окне Object Browser (Просмотр объектов) появляются дублирующие друг друга имена – если в верхнем списке выбрана строка <All Libraries> (<Все библиотеки>). Различить дубликаты можно, выделив одни из них и обратившись к нижней секции окна, где будет показано, к какой библиотеке относится выделенное ключевое слово.

В среду разработки встроено множество средств, помогающих писать выражения и операторы Visual Basic. Для включения и отключения этих средств в редакторе Visual Basic (Microsoft Excel, Word или Power Point) следует пометить (снять пометку) соответствующие флажки (таблица 2.1) в разделе Code Settings (Параметры программирования) на вкладке Editor (Редактор) диалогового окна Options (Параметры), которое открывается с помощью одноименной команды мены Tools (Сервис).

Таблица 2.1

Назначение флажков диалогового окна Options (Параметры)

Эти инструменты автоматически отображают информацию и предоставляют соответствующие варианты выбора на каждом этапе ввода выражения или оператора. Кроме того, в построении выражений в любой момент помогут такие команды в контекстном меню для модуля, как List Properties/Methods (Список свойств/методов), List Constants (Список констант), Quick Info (Сведения), Parameter Info (Параметры) или Complete Word (Завершить слово).

Когда в одном приложении создается объектная переменная, ссылающаяся на объект другого приложения, Visual Basic должен проверить, что этот объект существует, и что его свойства и методы заданы правильно. Такая проверка называется связыванием (binding). Связывание может проходить в период выполнения программы (позднее связывание) или на этапе компиляции (ранее связывание). Программа с поздним связыванием выполняется медленнее, чем программа с ранним связыванием. Кроме того, многие вспомогательные средства, встроенные в среду разработки, работают только при использовании раннего связывания.

Чтобы добиться раннего связывания кода, необходимо:

• установить ссылку на библиотеку типов, содержащую используемые объекты. Это осуществляется с помощью диалогового окна References (Ссылки);

• объявить тип объектных переменных в явном виде. Например, если в объектной переменной будет ссылка на объект Document, объявить переменную следует следующим образом:

Dim wdObject As Document

Не следует объявлять ее как универсальный тип Object:

Dim wdObject As Object

• если в программе используются объекты из нескольких библиотек типов, то при объявлении объектной переменной указывается имя приложения (особенно если в этих библиотеках есть одноименные объекты):

Dim wndXL As Excel.Window

Dim wndWD As Word.Window

Если свойство или метод, применяемые для получения ссылки на объект, возвращают не конкретный объектный тип, а универсальный тип Object, следует пойти на дополнительные меры, чтобы гарантировать для программы раннее связывание и возможность работы со средствами, помогающими в написании операторов. Например, в Microsoft Excel метод Item объекта Worksheets возвращает тип Object, а не Worksheet, поэтому следует явно объявить переменную типа Worksheet и присвоить ей значение выражения, возвращающего ссылку на объект Worksheet:

Dim testWS As Worksheet

Set testWS = Workbooks(1).Worksheets(1)

После ввода объектной переменной и следующей за ним точки, команда List Properties/Methods (Список свойств/методов) предложит на выбор свойства и методы объекта Worksheet, на который ссылается эта переменная.