Поделиться через


Элемент узла документа

Ведущий элемент Document является типом, который расширяет тип Document из основной сборки взаимодействия для Word. Ведущий элемент Document предоставляет все свойства, методы и события объекта Document , но также предоставляет дополнительные события и выступает в роли контейнера для элементов управления ведущего приложения и элементов управления Windows Forms.

Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO для Word. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

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

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

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

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

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

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

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

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

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

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