Přehled ovládací prvky hostitel a Host položky

Článek
03/04/2013

Položky hostitel a host jsou typy, které poskytuje programovací model pro řešení Office, které jsou vytvořeny pomocí nástroje pro vývoj Office v sadě Visual Studio.Položky hostitel a host provádět interakci s modely objekt aplikace Microsoft Office Word a Microsoft Office Excel, které jsou založeny na modelu COM, více jako interakci s spravované objekty, jako jsou například ovládací prvky model Windows Forms.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v následujících aplikacích: Excel 2013 a Excel 2010, Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Hostitel položky

Hostitel položky jsou typy, které jsou v horní části hierarchie modelu objektu v projektech systému Office.Visual Studio Tools for Office runtime Definuje následující položky hostitele aplikace Word a Excel řešení:

Každý z těchto typů rozšiřuje objekt, který nativně existuje v aplikaci Word nebo Excel objektový model, nazývá nativní objekt Office.Například Microsoft.Office.Tools.Word.Document položku hostitele rozšiřuje Microsoft.Office.Interop.Word.Document objekt, který je definován v primární sestavení interop pro aplikaci Word.

Položky hostitele obecně mají stejnou základní funkci jako odpovídající objekty Office, ale jsou rozšířené následující funkce:

Schopnost hostitele spravované ovládací prvky, včetně hostitelského prvků model Windows Forms.
Bohatší modely událostí.Některé události dokumentu, sešitu a listu v modelech objektu nativní aplikace Word a Excel jsou vyvolány pouze na úrovni aplikace.Položky hostitel poskytují tyto události na úrovni dokumentu tak, aby byly lépe zpracovávat události pro určitý dokument.

Principy hostitel položky projekty na úrovni dokumentu

V projekty na úrovni dokumentu položky hostitel poskytují vstupní bod pro váš kód a mají designery, které pomohou vyvíjet řešení.

Microsoft.Office.Tools.Word.Document a Microsoft.Office.Tools.Excel.Worksheet hostitel položky mají přidružené designery, které jsou vizuální reprezentace dokumentu nebo listu jako model Windows Forms Návrhář.Tento designer můžete upravit obsah dokumentu nebo listu přímo v aplikaci Word nebo Excel a přetažením ovládacích prvků na návrhové ploše.Další informace naleznete v tématu Položku hostitele dokumentu a Položku hostitele listu.

Microsoft.Office.Tools.Excel.Workbook Položku hostitele nejedná jako kontejner pro ovládací prvky, které mají uživatelské rozhraní.Místo toho návrháře pro tuto položku hostitele funguje jako zásobníku komponent umožňuje součásti, jako například přetažením DataSet, na povrch jeho návrhu.Další informace naleznete v tématu Položky sešitu hostitele.

Hostitel položky nelze programově v projekty na úrovni dokumentu.Místo toho použijte ThisDocument, ThisWorkbook, nebo Sheetn tříd, které aplikace Visual Studio automaticky generuje v projektu v době návrhu.Tyto generované třídy odvozeny od položkami hostitele a poskytují vstupní bod pro váš kód.Další informace naleznete v tématu Programová omezení položek hostitel a Host ovládací prvky.

Principy hostitel položky projekty na úrovni aplikace

Pokud vytvoříte doplněk aplikační úrovni, nemáte přístup k hostiteli položky ve výchozím nastavení.Však můžete generovat Microsoft.Office.Tools.Word.Document, Microsoft.Office.Tools.Excel.Workbook, a Microsoft.Office.Tools.Excel.Worksheet hostitele položek v aplikaci Word a Excel doplňky za běhu.

Po vytvoření položky hostitele můžete provádět úkoly, jako je přidání ovládacích prvků do dokumentů.Další informace naleznete v tématu Rozšíření dokumenty aplikace Word a Excel v doplňky úroveň aplikace v době spuštění.

Ovládací prvky hostitele

Ovládací prvky hostitel rozšířit různé objekty uživatelského rozhraní (UI) v aplikaci Word a Excel objektové modely, jako například Microsoft.Office.Interop.Word.ContentControl a Microsoft.Office.Interop.Excel.Range objekty.

Následující ovládací prvky hostitele jsou k dispozici pro projekty aplikace Excel:

Následující ovládací prvky hostitele jsou k dispozici pro projekty aplikace Word:

Hostitelský ovládací prvky, které jsou přidány do dokumentů sady Office se chovají jako nativní objekty Office; ovládací prvky hostitel však mají další funkce, včetně událostí a funkce datové vazby.Například, pokud chcete zachytit události nativní Microsoft.Office.Interop.Excel.Range objektu v aplikaci Excel, musí nejprve zpracovat událost změny listu.Pak je třeba určit, zda změna nastala v rámci Microsoft.Office.Interop.Excel.Range.Naopak Microsoft.Office.Tools.Excel.NamedRange hostitele ovládací prvek má Change události, kterou lze zpracovávat přímo.

Vztah mezi položku hostitele a ovládacími prvky hostitele je velmi podobný vztah mezi ovládacími prvky formuláře systému Windows a model Windows Forms.Stejně jako by umístit textové pole na formuláři, umístěte Microsoft.Office.Tools.Excel.NamedRange ovládat Microsoft.Office.Tools.Excel.Worksheet položku hostitele.Následující ilustrace znázorňuje vztah mezi položkami hostitele a ovládacími prvky hostitele.

Vztah mezi položky hostitel a host

Můžete také použít ovládací prvky model Windows Forms v řešeních Office přidáním přímo na povrch dokumentu aplikace Word a Excel.Další informace naleznete v tématu Ovládací prvky model Windows Forms na přehled dokumentů sady Office.

[!POZNÁMKA]

Přidání vnořeného dokumentu Word prvky hostitele nebo ovládací prvky model Windows Forms není podporováno.

Přidání ovládacích prvků hostitele do dokumentů

V projekty na úrovni dokumentu můžete přidat ovládací prvky hostitel dokumenty aplikace Word nebo tabulky aplikace Excel v době návrhu následujícími způsoby:

Přidání hostitele do dokumentu v době návrhu stejným způsobem by přidat nativní objekt.
Přetáhněte ovládací prvky hostitele z nástrojů na dokumenty a listy.Prvky hostitele aplikace Excel jsou k dispozici v Ovládací prvky aplikace Excel kartu v projektech aplikace Excel a Word hostitele jsou k dispozici v ovládacích prvcích Ovládací prvky aplikace Word kartu v projektech aplikace Word.
Přetáhněte ovládací prvky hostitele z Zdroje dat okna do dokumentů a listy.Umožňuje přidat ovládací prvky, které jsou již vázány na data.Další informace naleznete v tématu Vazba dat pro ovládací prvky v Office Solutions.

V dokumentu úrovni a na úrovni aplikace projekty lze také některé ovládací prvky hostitel dokumentů v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.

Další informace o tom, jak přidat ovládací prvky hostitel dokumentů naleznete v následujících tématech:

Ovládací prvky názvů hostitele

Při přetažení ovládacího prvku z hostitele nástrojů do dokumentu ovládací prvek automaticky názvem typu ovládacího prvku pomocí přírůstkové číslo na konci.Například jsou záložky s názvem bookmark1, bookmark2, atd.Pokud přidáte ovládací prvek pomocí nativní funkce aplikace Word nebo Excel, můžete jí specifický název při jeho vytvoření.Ovládací prvky lze také přejmenovat změnou hodnoty název vlastnost Vlastnosti okna.

[!POZNÁMKA]

Vyhrazená slova pro název hostitele ovládací prvky nelze použít.Například pokud přidáte NamedRange řízení listu a změňte název na systému, dojde při sestavení projektu.

Odstranění prvky hostitele

V projekty na úrovni dokumentu můžete odstranit hostitele ovládací prvky v době návrhu ovládacího prvku v listu aplikace Excel nebo dokument aplikace Word výběrem a stisknutím klávesy Delete.Musíte však použít Definovat název dialogové okno aplikace Excel odstranit NamedRange prvky.

Do dokumentu přidáte hostitelského ovládacího prvku v době návrhu, neměli byste je odstraňovat programově za běhu protože při příštím pokusu o použití ovládacího prvku v kódu, je vyvolána výjimka.Delete Metoda řízení hostitele odebere pouze hostitelský ovládací prvky, které jsou přidány do dokumentu za běhu.Pokud zavoláte Delete metoda hostitelského ovládacího prvku, který byl vytvořen v době návrhu, je vyvolána výjimka.

Například Delete metoda NamedRange odstraní pouze úspěšně NamedRange Pokud byl list, který je označován jako hostitelský ovládací prvky dynamicky vytváření programově přidány.Hostitele dynamicky vytvářených ovládacích prvků lze také odebrat předáním název ovládacího prvku Remove metoda Worksheet.Controls nebo Document.Controls vlastnost.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.

Koncoví uživatelé z dokumentu odstranit hostitelského ovládacího prvku za běhu, řešení zdařit neočekávanými způsoby.Odstranění chránit hostitelský ovládací prvky můžete použít funkce ochrany dokumentu v aplikaci Word a Excel.Další informace naleznete v tématu Ukázky vývoje Office a návody.

[!POZNÁMKA]

Neodstraňujte programově ovládací prvky během Shutdown obslužné rutiny události dokumentu nebo listu.Prvky uživatelského rozhraní jsou již k dispozici při Shutdown události.Pokud chcete odebrat ovládací prvky před aplikace zavře, přidat kód události obsluze jako BeforeClose nebo BeforeSave.

Programování proti hostitele události ovládacího prvku

Jedním způsobem, že hostitelský ovládací prvky rozšiřují objektů sady Office je přidání událostí.Například Microsoft.Office.Interop.Excel.Range objektu v aplikaci Excel a Microsoft.Office.Interop.Word.Bookmark objektu v aplikaci Word nemají události, ale Visual Studio Tools for Office runtime rozšiřuje tyto objekty přidáním programovatelné události.Můžete získat přístup a kód proti těmto událostem stejný způsob přístupu k události ovládacích prvků model Windows Forms: pomocí rozevíracího seznamu událostí v jazyce Visual Basic a stránku vlastností události v jazyce C#.Další informace naleznete v tématu Názorný postup: Programování proti událostem ovládacího prvku NamedRange.

[!POZNÁMKA]

Neměli byste nastavovat EnableEvents vlastnost Application objektu v aplikaci Excel a false.Nastavení této vlastnosti na false Excel zabrání vyvolání všech událostí, včetně událostí ovládacích prvků hostitele.