Položku hostitele dokumentu

Článek
03/04/2013

Document Položku hostitele je typ, který rozšiřuje Microsoft.Office.Interop.Word.Document typ z primární sestavení interop pro aplikaci Word.Document Položku hostitele poskytuje všechny stejné vlastnosti, metody a události, jako Microsoft.Office.Interop.Word.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 v aplikacích Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace 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 Úpravy dokumentu úroveň programování.

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 Microsoft.Office.Interop.Word.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 objektu 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 Microsoft.Office.Interop.Word.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 Microsoft.Office.Interop.Word.Document objekty.

Generování Document hostitele položku použít GetVstoObject metoda.Další informace naleznete v tématu Rozšíření dokumenty aplikace Word a Excel v doplňky úroveň aplikace v době spuštění.