- •Основные понятия технологии автоматизации
- •Структура пакета Microsoft Office
- •Методы взаимодействия с сервером автоматизации
- •Пример использования позднего связывания
- •Использование раннего связывания для доступа к объекту автоматизации
- •Пример использования раннего связывания
- •Компоненты Delphi для взаимодействия с серверами автоматизации ms Office
- •Взаимодействие с приложениями ms Office
- •Объект Documents
- •Основные методы и свойства объекта Document.
Взаимодействие с приложениями 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, выполняющих наиболее важные функции, такие как создание, открытие, закрытие и сохранение документов. Рассмотрим их более подробно:
метод 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;
метод 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 — определяет видимость окна, в котором открывается документ;
метод Save (NoPrornpt: OleVariant; Original Format: OleVariant) выполняет сохранение всех открытых документов. Для документов, сохраняемых первый раз, открывается окно диалога Сохранить как. Оба параметра этого метода являются необязательными и имеют следующее назначение:
NoPrornpt — определяет, выдавать (false) или нет (true) запрос на сохранение изменений в документе;
Original Format — задает формат сохраняемого документа. Значение данного свойства может быть одной из следующих констант; wdOrigi па 1DocumentFormat — сохранить документ в текущем формате; wdPromptUser — запросить формат пользователя; wdWordDocument — сохранить в формате MS Word;
Метод Close(SaveChanges: OleVariant; Original Format: OleVariant: RouteDocument:Oleariant) закрывает все открытые документы. Все параметры данного метода необязательны и имеют следующий смысл:
SaveChanges — определяет действия, выполняемые при закрытии документа. Значение данного параметра может быть задано с помощью одной из следующих констант: wdDoNotSaveChanges — не сохраняет изменения в документах;
wdPromptToSaveChanges — запрашивает у пользователя, сохранять изменения или нет; wdSaveChanges — сохраняет изменения в документах;
Original Format — задает формат документа при сохранении. Полностью аналогичен одноименному параметру метода Save;
RouteDocument — определяет, может данный документ быть отослан следующему получателю (true) или нет (false);
Метод Item(Index: OleVariant) возвращает ссылку на объект Document. С помощью параметра Index указывается либо порядковый номер документа, либо имя документа. Это возможно благодаря тому, что параметр передается с помощью
переменной типа OleVariant (переменные вариантного типа совместимы практически со всеми типами данных). Нумерация документов начинается с 1. Имя документа обязательно должно включать расширение.