Element hosta dokumentu

  • Artykuł

Element Document hosta jest typem, który rozszerza Document typ z podstawowego zestawu międzyoperacyjności dla programu Word. Element Document hosta zawiera wszystkie te same właściwości, metody i zdarzenia co Document obiekt, ale także uwidacznia dodatkowe zdarzenia i działa jako kontener dla kontrolek hosta i kontrolek Windows Forms.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla programu Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W projektach na poziomie dokumentu istnieje domyślny Document element hosta reprezentujący dokument w projekcie. W projektach dodatków VSTO można generować Document elementy hosta w czasie wykonywania.

Informacje o elemencie hosta dokumentu w projektach na poziomie dokumentu

Aby uzyskać dostęp do dokumentu w projekcie, użyj ThisDocument klasy . Podczas tworzenia projektu na poziomie dokumentu program Visual Studio generuje ThisDocument klasę, która będzie służyć jako link komunikacyjny między programem Word i kodem dostosowywania. Klasa ThisDocument zapewnia dostęp do elementów członkowskich Document elementu hosta w celu wykonywania podstawowych zadań w dostosowywaniu, takich jak uruchamianie kodu po otwarciu lub zamknięciu dokumentu. Możesz również użyć klasy , aby dodać kontrolki do dokumentu. Łącząc różne zestawy kontrolek i pisząc kod, można powiązać kontrolki z danymi, zbierać informacje od użytkownika i reagować na akcje użytkownika. Aby uzyskać więcej informacji, zobacz Dostosowywanie na poziomie dokumentu programu.

Klasa ThisDocument udostępnia lokalizację, w której można rozpocząć pisanie kodu w projekcie. Ponieważ klasa udostępnia wszystkie te same właściwości, metody i zdarzenia co Document obiekt w podstawowym zestawie międzyoperacyjnych dla programu Word, można również użyć ThisDocument do uzyskania dostępu do modelu obiektów programu Word. Aby uzyskać więcej informacji, zobacz Omówienie modelu obiektów programu Word.

Ograniczenia elementu hosta dokumentu w projektach na poziomie dokumentu

Projekt na poziomie dokumentu może zawierać tylko jeden Document element hosta (czyli klasę ThisDocument ). Nie można dodawać nowych Document elementów hosta do projektu w czasie projektowania i nie można tworzyć nowych Document elementów hosta w czasie wykonywania z dostosowania na poziomie dokumentu.

Jeśli utworzysz nowy dokument programu Word w czasie wykonywania, będzie to typ Document. Ponieważ nie jest to element hosta, nie może zawierać żadnych kontrolek hosta ani kontrolek formularzy systemu Windows. Aby uzyskać więcej informacji na temat tworzenia dokumentów w czasie wykonywania, zobacz Instrukcje: Programowe tworzenie nowych dokumentów.

Omówienie elementów hosta dokumentów w projektach na poziomie aplikacji

W projektach dodatków VSTO można wygenerować Document element hosta w czasie wykonywania dla dowolnego dokumentu otwartego w programie Word. Za pomocą Document elementu hosta można dodawać kontrolki do skojarzonego dokumentu lub obsługiwać zdarzenia, które nie są dostępne w Document obiektach.

Aby wygenerować Document element hosta, użyj GetVstoObject metody . Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów programu Excel w dodatku VSTO w czasie wykonywania.

Powiązana zawartość