Element hosta dokumentu
Document Hosta, towaru jest typ, który rozszerza Document typu od podstawowy zestaw międzyoperacyjny dla programu Word.Document Elementu hosta zawiera wszystkie właściwości, metod i zdarzeń jako Document obiektu, ale także udostępnia dodatkowe zdarzenia i działa jako kontener dla hosta kontroli i kontroli Windows Forms.
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w programach Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach 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 Programowanie dostosowań na poziome dokumentu.
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 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 Model obiektu Word — Omówienie.
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 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 Document obiektów.
Do generowania Document hosta przedmiot, użyj GetVstoObject metoda.Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów w programie Excel w czasie wykonywania w dodatkach na poziomie aplikacji.
Zobacz też
Koncepcje
Przegląd obiektów hosta i formantów hosta
Automatyzowanie programu Word za pomocą obiektów rozszerzonych
Ograniczenia programowe elementów hosta i formantów hosta