Hostitelská položka listu
Hostitelská Worksheet položka je typ, který rozšiřuje typ z primárního Worksheet sestavení zprostředkovatele komunikace pro Excel. Položka Worksheet hostitele poskytuje všechny stejné vlastnosti, metody a události jako Worksheet 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 Excel. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.
V projektech na úrovni dokumentu můžete přidávat Worksheet položky hostitele do projektu v době návrhu. V projektech doplňků VSTO můžete vygenerovat Worksheet hostitelské položky za běhu.
Principy hostitelských položek listu v projektech na úrovni dokumentu
Při vytváření projektu na úrovni dokumentu pro Excel sada Visual Studio automaticky vytvoří tři Worksheet hostitelské položky v projektu. Výchozí názvy listů jsou Sheet1
, Sheet2
a Sheet3
. Pokud vytvoříte projekt založený na existujícím sešitu, počet hostitelských položek závisí na počtu listů v sešitu.
Tyto třídy listu umožňují přístup členům Worksheet položky hostitele k provádění základních úloh v přizpůsobení, například úpravě obsahu listu. Tyto třídy můžete také použít k přidání ovládacích prvků do listů. 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řídy listu poskytují 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 Worksheet objekt v primárním sestavení vzájemné spolupráce pro Excel, můžete také tyto třídy použít pro přístup k objektového modelu aplikace Excel. Další informace naleznete v tématu Přehled objektového modelu aplikace Excel.
V projektech na úrovni dokumentu můžete do projektu přidat další Worksheet hostitelské položky v době návrhu přidáním nového listu do sešitu v návrháři.
Přejmenování listů
V projektu na úrovni dokumentu můžete listy přejmenovat v návrháři sady Visual Studio, ale změní se jenom zobrazovaný název listu. Programový název je stále výchozím názvem listu. Pokud list přejmenujete v okně Vlastnosti , změní se pouze název programu.
Omezení položky hostitele listu v projektech na úrovni dokumentu
V projektu na úrovni dokumentu nelze vytvářet nové Worksheet položky hostitele za běhu. Pokud vytvoříte nový excelový list za běhu, bude to typ Worksheet. 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 naleznete v tématu Postupy: Přidávání nových listů do sešitů prostřednictvím kódu programu.
Principy hostitelských položek listu v projektech doplňků VSTO
Vprojektechch Worksheet Položku hostitele můžete použít Worksheet k přidání ovládacích prvků do přidruženého listu nebo ke zpracování událostí, které nejsou k dispozici u Worksheet objektů.
K vygenerování Worksheet 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
- Ukázky a názorné postupy pro vývoj pro Office
- Rozšíření wordových dokumentů a excelových sešitů v doplňcích VSTO za běhu
- Ovládací prvky v dokumentech Office
- Přidání ovládacích prvků do dokumentů Office za běhu
- Přehled hostitelských položek a ovládacích prvků hostitele
- Hostitelská položka sešitu
- Automatizace Excelu pomocí rozšířených objektů
- Programová omezení hostitelských položek a hostitelských ovládacích prvků