Объект Range

Объект Range представляет непрерывную (последовательную) область в документе и определяется позициями начального и конечного символов. Вы не ограничены одним объектом Range - в одном документе можно определить сразу несколько таких объектов. Вот характеристики объекта Range:

1. может включать только курсор ввода, диапазон текста или весь документ;

2. содержит непечатаемые символы вроде пробелов, табуляторов и знаков абзацев;

3. может быть областью, как соответствующей, так и не соответствующей текущему выделенному фрагменту;

4. является динамическим, т. е. существует до тех пор, пока выполняется создавший его код.

Если вы вставляете текст в конец диапазона, Word автоматически расширяет диапазон, чтобы охватить и новый текст.

Объект Bookmark

Объект Bookmark аналогичен объекту Range в том смысле, что представляет непрерывную область в документе и тоже имеет начальную и конечную позиции. Вы можете использовать закладки (bookmarks), чтобы помечать какое-либо место в документе, или как контейнер текста в документе. Объект Bookmark может охватывать что угодно - только курсор ввода или весь документ. В документе можно определить несоклько закладок. Следующие характеристики Bookmark отличают его от объекта Range:

1. вы можете присваивать имя объекту Bookmark;

2. он сохраняется вместе с документом и не уничтожается по завершении породившего его кода или после закрытия документа;

3. по умолчанию он скрыт, но вы можете сделать его видимым, установив свойство ShowBookmarks объекта View в True. (Объект View является членом объектов Window и Pane, которые содержатся в объектах Application и Document.)

Подведем промежуточный итог

Вот несколько вариантов использования объектов Selection, Range и Bookmark.

1. Закладки удобны в шаблонах. Например, шаблон делового письма может содержать закладки там, где нужно вставлять данные из базы данных. В период выполнения ваш код может создать новый документ на основе этого шаблона, получить данные из базы, найти именованную закладку и вставить текст в нужную позицию.

2. Если вы хотите изменить текст внутри Bookmark, используйте его свойство Range для создания объекта Range, а затем вызывайте один из методов этого объекта для изменения текста.

3. С помощью объекта Bookmark можно определить в документе стереотипный текст. Вы указываете его содержимое, используя в качестве источника объект Range или Selection. Впоследствии вы сможете переходить к различным объектам Bookmark по каким-либо условиям для копирования и вставки стереотипного текста в другие документы.

Это лишь малая часть вариантов применения этих объектов для построения мощных пользовательских приложений.

Объект Application

Word-объект Application представляет само приложение Word. Всякий раз, когда вы пишете код, вы начинаете с объекта Application. Через него можно обращаться к любым другим объектам и наборам (collections), предоставляемым Word, а также к методам и свойствам самого объекта Application.

Использование ThisApplication

Если вы работаете в Word, объект Application создается автоматически, и вы можете через свойство Application получить ссылку на Word-объект Application. Создавая решения в Visual Studio .NET, вы можете использовать переменную ThisApplication, которая определяется за вас внутри класса OfficeCodeBehind.

Если вы программируете Word вне этого класса, то должны сами создать объектную переменную для Word-объекта Application, а затем создать экземпляр Word:

view source

print?

1.' Visual Basic

2.Dim appWord As Word.Application = _

3. New Word.Application

4.   

5.// C#

Word.Application appWord = new Word.Application();

Совет Переменная Word.Application, объявленная в вашем классе OfficeCodeBehind, позволяет работать так же, как и при использовании ThisApplication. Однако при этом нужен дополнительный шаг для явного создания новой переменной Word.Application, тогда как ThisApplication создается автоматически.

При ссылках на объекты и наборы, расположенные в иерархии ниже объекта Application, явно ссылаться на объект Application не требуется. Например, вы можете ссылаться на активный документ через встроенное свойство ThisDocument, не указывая объект Application. ThisDocument ссылается на активный документ и позволяет работать с членами объекта Document. (Об этом объекте будет детально рассказано позже.)

Совет Вероятно, чаще всего вы будете пользоваться свойством ThisApplication.ActiveDocument, которое ссылается на активный объект Document. Но, как правило, удобнее работать с синтаксисом ThisDocument, а не ThisApplication.ActiveDocument. Дело в том, что в первом случае вам придется полностью определять ссылку с указанием объекта Application. Применение ThisDocument эффективнее, так как нужная переменная уже создана за вас.