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

Каждый из элементов коллекции Documents представляет собой ссылку на объект Document, являющийся документом, открытым в приложении MS Word. Объект Document имеет довольно сложную структуру и содержит большое количество встроенных объектов. Для упрощения программирования работы с объектами Document в VCL Delphi имеется специальный класс TWordDocument.

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

Основные свойства объекта Document

Свойство Тип Описание

AttachedTemplate Template Объект, указывающий на шаблон документа

AutoHyphenation Boolean Включает (true) или выключает (false) режим автоматической расстановки переносов.

Content Range Объект, содержащий весь текст документа

FullName WideString Имя документа и путь к нему

GrammarChecked Boolean Определяет, была выполнена проверка грамматики в документе (true) или нет (false)

GrammaticalErrors ProofreadingErrors Коллекция объектов Range, каждый из которых содержит предложение с грамматическими ошибками, найденными в документе. Каждое предложение может содержать несколько ошибок. При отсутствии ошибок принимает значение 0.

Name WideString Имя файла документа

PageSetup PageSetup Объект, содержащий параметры страниц документа (поля, размер бумаги и т. п.)

Paragraphs Paragraphs Коллекция объектов Paragraph, каждый из которых является абзацем в документе.

Содержит все абзацы документа.

Readonly Boolean Включает (true) или выключает (false) режим «только для чтения» (read only)

Saved Boolean Определяет, были (false) или нет (true) внесены изменения в документ с момента

последнего сохранения.

SaveFormat Integer Формат документа

ShowSpellingErrors Boolean Включает (true) или выключает (false) режим подчеркивания слов с

орфографическими ошибками.

ShowGrammaticalErrors Boolean Включает (true) или выключает (false) режим подчеркивания предложений

с грамматическими ошибками.

Styles Styles Коллекция объектов Style, содержащая все стили документа

Tables Tables Коллекция объектов Table, содержащая все таблицы документа

TablesOfContents TablesOfContents Коллекция объектов TablesOfContent, содержащая все оглавления документа

Type_ TOLEEnuq Тип документа:

• wdTypeDocument — обычный документ;

• wdTypeTemplate — шаблон

Words Words Коллекция объектов Word, содержащая все слова документа

Методы объекта Document позволяют выполнять различные действия с документами. Рассмотрим назначение нескольких основных методов более подробно:

• метод CheckSpelling выполняет проверку орфографии в документе. При обнаружении ошибки содержащее документ окно MS Word становится активным и отображается окно диалога Правописание;

• метод Close(SaveChanges. OriginalFormat. RouteDocument) закрывает документ. Данный метод полностью аналогичен методу Close объекта Documents;

• метод Range(Start: OleVariant; End: OleVariant) возвращает объект Range, содержащий фрагмент текста документа начиная с символа, имеющего порядковый номер Start и заканчивая символом с порядковым номером End. Невидимые символы также учитываются при создании объекта Range;

• метод Save(NoPrornpt, Original Format) аналогичен методу Save объекта Documents;

• метод Acti vate делает документ активным;

• метод Undo (Times: OleVariant) отменяет последние выполненные действия. Возвращает значение true, если действия были успешно отменены. Количество отменяемых действий определяется параметром Times.