Ведущий элемент документа
Обновлен: Июль 2008
Применение |
|---|
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office. Проекты уровня документа
Проекты уровня приложения
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Ведущий элемент Document представляет документ Word, который предоставляет события и действует как контейнер для элементов управления ведущего приложения и Windows Forms. Ведущий элемент Document также предоставляет те же свойства, методы и события, что и класс Microsoft.Office.Interop.Word.Document в основной сборке взаимодействия для Word.
В проектах уровня документа существует ведущий элемент Document, который представляет документ в проекте. Начиная с Visual Studio 2008 с пакетом обновлений 1 (SP 1), можно также создавать ведущие элементы Document во время выполнения, используя надстройку уровня приложения для Word 2007.
Оснвные сведения о ведущих элементах документа в проектах уровня документа
Для обращения к документу в проекте программными средствами используется класс ThisDocument. При создании проекта уровня документа Visual Studio Tools for Office создает класс ThisDocument, который используется для связи между Word и кодом настройки. Класс ThisDocument наследуется от класса ведущего элемента Document. При открытии документа во время выполнения в Visual Studio Tools for Office автоматически создается экземпляр класса ThisDocument. Не следует пытаться создать класс Document напрямую в коде.
Класс ThisDocument обеспечивает доступ к членам класса ведущего элемента Document и предназначен для выполнения основных задач по настройке, например для запуска кода при открытии или закрытии документа. Также можно использовать этот класс для добавления элементов управления и смарт-тегов в документ. Используя различные сочетания элементов управления и кода, можно связывать элементы управления с данными, собирать вводимые пользователем сведения и реагировать на действия пользователя. Дополнительные сведения см. в разделе Настройки программирования уровня документа.
Класс ThisDocument предоставляет местоположение, в котором можно начать написание кода в проекте. Поскольку этот класс содержит те же свойства, методы и события, что и класс Microsoft.Office.Interop.Word.Document в основной сборке взаимодействия для Word, класс ThisDocument можно использовать для обращения к объектной модели приложения Word. Дополнительные сведения см. в разделе Общие сведения об объектной модели Word.
Ограничения, применяемые к ведущему элементу документа
В проекте уровня документа может содержаться только один ведущий элемент класса Document. Во время разработки не допускается добавление новых ведущих элементов класса Document в проект. Также не допускается создание новых ведущих элементов класса Document программными средствами во время выполнения из настройки уровня документа.
При создании нового документа Word во время выполнения ему присваивается тип Microsoft.Office.Interop.Word.Document. Поскольку такой документ не является ведущим элементом, он не может содержать элементы управления ведущего приложения или Windows Forms. Дополнительные сведения о создании документов во время выполнения см. в разделе Практическое руководство. Создание новых документов.
Основные сведения о ведущих эелементах документа в проектах уровня приложения
Начиная с пакета обновления 1 (SP1), можно создавать ведущий элемент Document во время выполнения для любого документа, открытого в Word. Ведущий элемент Document можно использовать для добавления элементов управления и смарт-тегов в связанный документ.
Для создания ведущего элемента Document используется метод GetVstoObject любого объекта Microsoft.Office.Interop.Word.Document. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.
См. также
Основные понятия
Общие сведения о ведущих элементах и элементах управления ведущего приложения
Общие сведения об объектной модели Word
Программные ограничения ведущих элементов и элементов управления ведущего приложения
Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения
Другие ресурсы
Элементы управления ведущего приложения Word
Элементы управления ведущего приложения Excel
Журнал изменений
Дата |
Журнал изменений |
Причина |
|---|---|---|
Июль 2008 |
Добавлены сведения об использовании ведущих элементов Document в проектах уровня приложения. |
Изменение функции SP1. |