Взаимодействие с приложениями ms Office

Основные методы и свойства объекта Application

Объект Application содержит лишь небольшое число методов и свойств, к которым возникает необходимость обращаться при управлении приложением MS Word извне. Тем не менее некоторые из свойств очень важны, поэтому мы их рассмотрим подробнее.

К основным свойствам объекта Appl ication можно отнести следующие:

• Visible: Boolean — управляет видимостью окна приложения MS Word. Если значение этого свойства задано равным false, то, несмотря на то что MS Word запущен, пользователь не будет его видеть;

• ActiveDocument: Document — ссылка на объект Document, который в текущий момент является активным;

• Options: Options — объект, содержащий описание параметров MS Word;

• Documents: Documents — коллекция объектов Document, содержащая все открытые в данный момент документы;

• Selection: Selection—указывает на выделенный фрагмент текста или на текущую позицию курсора.

Из методов объекта Application выделим один: метод Quit(SaveChanges, Format) — закрывает приложение MS Word. Параметр SaveChanges указывает, следует ли сохранять изменения в открытых документах. Его возможные значения:

• wdDoNotSaveChanges — не сохранять изменения;

• wdPromptToSaveChanges — запросить у пользователя, сохранять ли изменения;

• wdSaveChanges — сохранить изменения.

Параметр Format позволяет задать формат, в котором документы будут сохранены:

• wdOriginalDocumentFormat — сохранить в исходном формате;

• wdPromptUser — запросить формат у пользователя;

• wdWordDocument — сохранить в формате документа Word.

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

Объект Documents

Коллекция Documents содержит все открытые в текущий момент документы (объекты Document). Объект Documents обладает всего четырьмя свойствами, из которых наиболее важным является свойство Count, имеющее тип Integer и содержащее информацию о количестве открытых документов.

Можно выделить ряд методов коллекции Documents, выполняющих наиболее важные функции, такие как создание, открытие, закрытие и сохранение документов. Рассмотрим их более подробно:

1. метод Add (Template: OleVariant; NewTemplate: OleVanant; DocumentType: OleVariant; Visible: OleVariant) создает новый документ. Все параметры данного метода являются необязательными и имеют следующий смысл:

• Template — имя шаблона, на основе которого будет создан новый документ. Если данный параметр не указан (точнее, если вместо него указано значение EmptyParam), то документ создается на основе шаблона normal.dot;

• NewTemplate — указывает, создается обычный документ (false) пли шаблон (true). По умолчанию имеет значение false;

• DocumentType — указывает тип создаваемого документа. Возможны следующие значения: wdNewBlankDocument, wdNewEmailMessage, wdNewFrameset, wdNewWebPage. По умолчанию имеет значение wdNewBlankDocument;

• Visible — определяет, будет отображаться окно с созданным документом (true) или нет (false). Значение по умолчанию true;

2. метод Open (FileName: OleVariant; ConfirmConversions: OleVanant; Readonly: OleVariant; AddToRecentFiles: OleVanant; PasswordDocument: OleVariant; PasswordTemplate: OleVariant; Revert: OleVariant; WritePasswordDocument: OleVariant; WritePasswordTemplate: OleVariant; Format: OleVariant; Encoding: OleVariant; Visible: OleVariant) открывает существующий (созданный ранее) документ. Из всех параметров метода Open обязательным является только первый — FileName, который задает имя открываемого файла. Остальные параметры имеют следующий смысл:

• ConfirmConversions — определяет, отображать (true) или нет (false) окно диалога Преобразование файла, если файл не является документом MS Word;

• Readonly — задание данного параметра равным true означает, что документ будет открыт в режиме «только для чтения»;

• AddToRecentFiles — определяет, заносить (true) или нет (false) открываемый документ в список недавно использованных файлов, расположенный в нижней части меню Файл;

• PasswordDocument — пароль для открытия документа;

• PasswordTemplate — пароль для открытия шаблона;

• Revert — при попытке вторичного открытия уже открытого документа данный параметр определяет выполняемое при этом действие: игнорировать все изменения, внесенные в документ, и открыть файл заново (true) или продолжить работу с уже открытым документом (false);

• WritePasswordDocument — пароль для сохранения внесенных в документ изменений;

• WritePasswordTemplate — пароль для сохранения внесенных в шаблон изменений;

• Format — определяет фильтр, используемый при открытии документа. Может задаваться с помощью одной из констант, приведенных в таблице. По умолчанию этот параметр имеет значение wdOpenFormatAuto;

Константы, определяющие формат открываемого файла

Константа Формат файла

wdOpenFormatAIIWord Документ MS Word

wdOpenFormatAuto Формат определяется автоматически

wdOpenFormatDocument Документ MS Word 2000

wdOpenFormatEncodedText Текстовый файл

wdOpenFormatRTF Текст в формате RTF

wdOpenFormatTemplate Шаблон MS Word

wdOpenFormatText Текст в формате ASCII

wdOpenFormatUnicodeText Текст в формате UNICODE

wdOpenFormatWebPages HTML-документ

• Encoding — задает кодовую страницу, которая используется в MS Word при отображении документа. По умолчанию используется системная кодовая таблица;

• Visible — определяет видимость окна, в котором открывается документ;

3. метод Save (NoPrornpt: OleVariant; Original Format: OleVariant) выполняет сохранение всех открытых документов. Для документов, сохраняемых первый раз, открывается окно диалога Сохранить как. Оба параметра этого метода являются необязательными и имеют следующее назначение:

• NoPrornpt — определяет, выдавать (false) или нет (true) запрос на сохранение изменений в документе;

• Original Format — задает формат сохраняемого документа. Значение данного свойства может быть одной из следующих констант; wdOrigi па 1DocumentFormat — сохранить документ в текущем формате; wdPromptUser — запросить формат пользователя; wdWordDocument — сохранить в формате MS Word;

4. Метод Close(SaveChanges: OleVariant; Original Format: OleVariant: RouteDocument:Oleariant) закрывает все открытые документы. Все параметры данного метода необязательны и имеют следующий смысл:

• SaveChanges — определяет действия, выполняемые при закрытии документа. Значение данного параметра может быть задано с помощью одной из следующих констант: wdDoNotSaveChanges — не сохраняет изменения в документах;

• wdPromptToSaveChanges — запрашивает у пользователя, сохранять изменения или нет; wdSaveChanges — сохраняет изменения в документах;

• Original Format — задает формат документа при сохранении. Полностью аналогичен одноименному параметру метода Save;

• RouteDocument — определяет, может данный документ быть отослан следующему получателю (true) или нет (false);

5. Метод Item(Index: OleVariant) возвращает ссылку на объект Document. С помощью параметра Index указывается либо порядковый номер документа, либо имя документа. Это возможно благодаря тому, что параметр передается с помощью

переменной типа OleVariant (переменные вариантного типа совместимы практически со всеми типами данных). Нумерация документов начинается с 1. Имя документа обязательно должно включать расширение.