Sdílet prostřednictvím

Hostitelská položka listu

  • Článek

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, Sheet2a 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