Ведущий элемент документа

Статья
02/20/2013

Ведущий элемент Document является типом, который расширяет тип Microsoft.Office.Interop.Word.Document из основной сборки взаимодействия для Word.Ведущий элемент Document предоставляет все те же свойства, методы и события, что и объект Microsoft.Office.Interop.Word.Document, однако также содержит дополнительные события и выполняет функцию контейнера для ведущих элементов управления и элементов управления Windows Forms.

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

В проектах уровня документа существует ведущий элемент Document, который представляет документ в проекте.В проектах уровня приложения можно создавать ведущие элементы Document во время выполнения.

Оснвные сведения о ведущих элементах документа в проектах уровня документа

Для обращения к документу в проекте используется класс ThisDocument.При создании проекта уровня документа Visual Studio создает класс ThisDocument, который используется для связи между Word и кодом настройки.Класс ThisDocument обеспечивает доступ к членам класса ведущего элемента Document и предназначен для выполнения основных задач по настройке, например для запуска кода при открытии или закрытии документа.Также можно использовать класс для добавления элементов управления в документ.Используя различные сочетания элементов управления и кода, можно связывать элементы управления с данными, собирать вводимые пользователем сведения и реагировать на действия пользователя.Дополнительные сведения см. в разделе Настройки программирования уровня документа.

Класс ThisDocument предоставляет местоположение, в котором можно начать написание кода в проекте.Поскольку этот класс содержит те же свойства, методы и события, что и объект Microsoft.Office.Interop.Word.Document в основной сборке взаимодействия для Word, класс ThisDocument можно использовать для обращения к объектной модели приложения Word.Дополнительные сведения см. в разделе Общие сведения об объектной модели Word.

Ограничения ведущих элементов документов в проектах уровня документа

Проект уровня документа может содержать только один ведущий элемент Document (класс ThisDocument).Во время разработки не допускается добавление новых ведущих элементов класса Document в проект. Также не допускается создание новых ведущих элементов класса Document во время выполнения из настройки уровня документа.

При создании нового документа Word во время выполнения ему присваивается тип Microsoft.Office.Interop.Word.Document.Поскольку такой документ не является ведущим элементом, он не может содержать элементы управления ведущего приложения или Windows Forms.Дополнительные сведения о создании документов во время выполнения см. в разделе Практическое руководство. Программное создание документов.

Основные сведения о ведущих эелементах документа в проектах уровня приложения

В проектах уровня приложения можно создавать ведущий элемент Document во время выполнения для любого документа, открытого в Word.Ведущий элемент Document можно использовать для добавления элементов управления в документ, связанный или для обработки событий, которые недоступны в Microsoft.Office.Interop.Word.Document возражает.

Чтобы создать ведущий элемент Document, используйте метод GetVstoObject.Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.