Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Хост-элемент 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 во время выполнения".