Element hosta dokumentu

Artykuł
02/27/2013

Document Hosta, towaru jest typ, który rozszerza Microsoft.Office.Interop.Word.Document typu od podstawowy zestaw międzyoperacyjny dla programu Word.Document Elementu hosta zawiera wszystkie właściwości, metod i zdarzeń jako Microsoft.Office.Interop.Word.Document obiektu, ale także udostępnia dodatkowe zdarzenia i działa jako kontener dla hosta kontroli i kontroli Windows Forms.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu i projektów na poziomie aplikacji dla programów Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

W przypadku projektów na poziomie dokumentu, jest domyślnie Document element hosta, który reprezentuje dokument w projekcie.W przypadku projektów na poziomie aplikacji, można wygenerować Document host elementów w czasie wykonywania.

Opis elementu hosta dokumentu w projektów na poziomie dokumentu

Dostęp do dokumentów w projekcie, należy użyć ThisDocument klasy.Podczas tworzenia projektu na poziomie dokumentu, Visual Studio generuje ThisDocument klasy, aby służyć jako łącze komunikacyjne pomiędzy programem Word a Twój kod dostosowania.ThisDocument Klasy daje dostęp do członków Document elementu hosta wykonywania podstawowych zadań w dostosowań, takich jak wykonywanie kodu, gdy dokument jest otwarty lub zamknięty.Aby dodać formanty do dokumentu umożliwia także klasy.Łącząc różne zestawy formantów i pisania kodu, formanty można powiązać z danymi, zbieranie informacji od użytkownika i reagować na działania użytkownika.Aby uzyskać więcej informacji, zobacz Dostosowania poziomu dokument programowania.

ThisDocument Klasy zawiera lokalizację, w którym można rozpocząć pisanie kodu do projektu.Ponieważ klasa zawiera wszystkie właściwości, metod i zdarzeń jako Microsoft.Office.Interop.Word.Document obiektu w podstawowy zestaw międzyoperacyjny dla programu Word, można również użyć ThisDocument dostępu do modelu obiektu programu Word.Aby uzyskać więcej informacji, zobacz Program Word omówienie modelu obiektu.

Ograniczenia elementu dokumentu hosta z projektów na poziomie dokumentu

Projekt na poziomie dokumentu może zawierać tylko jedną Document hosta, towaru (czyli ThisDocument klasy).Nie można dodać nowy Document hosta elementy do projektu w czasie projektowania i nie można utworzyć nowy Document host elementów w czasie wykonywania, od dostosowywania poziomie dokumentu.

Jeśli tworzysz nowy dokument programu Word w czasie wykonywania, będzie typu Microsoft.Office.Interop.Word.Document.Ponieważ nie jest elementem hosta, nie może zawierać żadnych hosta formantów lub formanty Windows Forms.Aby uzyskać więcej informacji na temat tworzenia dokumentów w czasie wykonywania, zobacz Porady: Programowane tworzenie nowych dokumentów.

Opis elementów hosta dokumentu w poziomie aplikacji

W przypadku projektów na poziomie aplikacji, można wygenerować Document elementu hosta w czasie wykonywania dla dowolnego dokumentu, który jest otwarty w programie Word.Można użyć Document elementu hosta, aby dodać formanty do skojarzonego dokumentu lub do obsługi zdarzeń, które nie są dostępne na Microsoft.Office.Interop.Word.Document obiektów.

Do generowania Document hosta przedmiot, użyj GetVstoObject metoda.Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumenty programu Word oraz skoroszyty programu Excel w dodatki poziomie aplikacji w czasie wykonywania.