Sdílet prostřednictvím


Hostitelská položka Document

Document Položku hostitele je typ, který rozšiřuje Document typ z primární sestavení interop pro aplikaci Word.Document Položku hostitele poskytuje všechny stejné vlastnosti, metody a události, jako Document objekt, ale také poskytuje další události a funguje jako kontejner pro ovládací prvky hostitel a model Windows Forms.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace ve Wordu 2013 a ve Wordu 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

V projektech úrovni dokumentu je výchozí Document hostitele položku, která představuje dokument v projektu.Projekty na úrovni aplikace, je možné generovat Document hostitel položky za běhu.

Principy položku hostitele dokumentu v projekty na úrovni dokumentu

Přístup k dokumentu v projektu, použijte ThisDocument třídy.Při vytváření dokumentu úroveň projektu aplikace Visual Studio generuje ThisDocument třída slouží jako komunikační propojení mezi Word a ve vlastním kódu.ThisDocument Třída umožňuje přístup k členům Document položku hostitele provádět základní úkoly v přizpůsobení, jako je spuštění kódu při otevření nebo zavření dokumentu.Můžete také použít třídu dokumentu přidat ovládací prvky.Kombinování různých sad ovládacích prvků a psaní kódu, že můžete svázat ovládací prvky s daty, shromažďovat informace od uživatele a reagují na akce uživatele.Další informace naleznete v tématu Programování přizpůsobení na úrovni dokumentu.

ThisDocument Třída poskytuje umístění, ve kterém lze spustit psaní kódu v projektu.Protože třída poskytuje všechny stejné vlastnosti, metody a události, jako Document objektu v primární sestavení interop pro aplikaci Word, můžete použít ThisDocument přístup k objektovému modelu aplikace Word.Další informace naleznete v tématu Přehled modelu objektů aplikace Word.

Omezení položku hostitele dokumentu v projekty na úrovni dokumentu

Úroveň dokumentu projektu může obsahovat pouze jeden Document položku hostitele (, ThisDocument třídy).Nelze přidat nový Document hostitel položky projektu v době návrhu a nelze vytvořit nový Document hostitel položky za běhu z přizpůsobení úroveň dokument.

Pokud vytvoříte nový dokument aplikace Word v době běhu, je typu Document.Protože položka hostitel není, nemůže obsahovat žádné prvky hostitele nebo ovládací prvky model Windows Forms.Další informace o vytváření dokumentů v době spuštění naleznete v Postupy: Vytváření nových dokumentů prostřednictvím kódu programu.

Principy položky dokumentu hostitelské projekty na úrovni aplikace

Projekty na úrovni aplikace, je možné generovat Document položku hostitele za běhu pro libovolný dokument, který je otevřen v aplikaci Word.Můžete použít Document položku hostitele přidružený dokumentu přidat ovládací prvky nebo zpracování událostí, které nejsou k dispozici na Document objekty.

Generování Document hostitele položku použít GetVstoObject metoda.Další informace naleznete v tématu Rozšíření dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu.

Viz také

Koncepty

Přehled hostitelských položek a hostitelských ovládacích prvků

Automatizace v aplikaci Word s použitím rozšířených objektů

Programová omezení hostitelských položek a hostitelských ovládacích prvků

Rozšíření dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu

Další zdroje

Přehled modelu objektů aplikace Word