Položka hostitele dokumentu

  • Článek

Položka Document hostitele je typ, který rozšiřuje typ z primárního Document sestavení zprostředkovatele komunikace pro Word. Položka Document hostitele poskytuje všechny stejné vlastnosti, metody a události jako Document objekt, ale také zveřejňuje další události a funguje jako kontejner pro ovládací prvky hostitele a model Windows Forms ovládací prvky.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO pro Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

V projektech na úrovni dokumentu existuje výchozí Document položka hostitele, která představuje dokument v projektu. V projektech doplňků VSTO můžete vygenerovat Document hostitelské položky za běhu.

Vysvětlení položky hostitele dokumentu v projektech na úrovni dokumentu

Pokud chcete získat přístup k dokumentu v projektu, použijte ThisDocument třídu. Když vytvoříte projekt na úrovni dokumentu, Visual Studio vygeneruje ThisDocument třídu, která bude sloužit jako komunikační propojení mezi Wordem a kódem pro přizpůsobení. Třída ThisDocument poskytuje přístup členům Document položky hostitele k provádění základních úloh v přizpůsobení, jako je spuštění kódu při otevření nebo zavření dokumentu. Třídu můžete také použít k přidání ovládacích prvků do dokumentu. Kombinací různých sad ovládacích prvků a psaní kódu můžete svázat ovládací prvky s daty, shromažďovat informace od uživatele a reagovat na akce uživatele. Další informace naleznete v tématu Program přizpůsobení na úrovni dokumentu.

Třída ThisDocument poskytuje umístění, ve kterém můžete začít psát kód v projektu. Vzhledem k tomu, že třída poskytuje všechny stejné vlastnosti, metody a události jako Document objekt v primárním sestavení vzájemné spolupráce pro Word, můžete také použít ThisDocument pro přístup k objektového modelu wordu. Další informace naleznete v tématu Přehled objektového modelu aplikace Word.

Omezení položky hostitele dokumentu v projektech na úrovni dokumentu

Projekt na úrovni dokumentu může obsahovat pouze jednu Document položku hostitele (to znamená ThisDocument třídu). V době návrhu nelze do projektu přidávat nové Document hostitelské položky a nemůžete vytvářet nové Document položky hostitele za běhu z přizpůsobení na úrovni dokumentu.

Pokud vytvoříte nový wordový dokument za běhu, bude to typ Document. Protože se nejedná o položku hostitele, nemůže obsahovat žádné ovládací prvky hostitele ani ovládací prvky model Windows Forms. Další informace o vytváření dokumentů za běhu najdete v tématu Postupy: Programové vytváření nových dokumentů.

Principy položek hostitele dokumentu v projektech na úrovni aplikace

V projektech doplňků VSTO můžete vygenerovat Document položku hostitele za běhu pro libovolný dokument, který je otevřený ve Wordu. Položku hostitele můžete použít Document k přidání ovládacích prvků do přidruženého dokumentu nebo ke zpracování událostí, které nejsou k dispozici u Document objektů.

K vygenerování Document položky hostitele použijte metodu GetVstoObject . Další informace naleznete v tématu Rozšíření wordových dokumentů a excelových sešitů v doplňkech VSTO za běhu.

Související obsah