Sdílet prostřednictvím

Vlastní podokna úloh

  • Článek

Panely uživatelské rozhraní, které jsou obvykle ukotven na jedné straně okna v aplikaci Microsoft Office jsou podokna úloh.Vlastní podokna úloh umožňují vytvořit vlastní podokno úloh a poskytnout uživatelům známé rozhraní pro přístup k funkcím vašeho řešení.Rozhraní může například obsahovat ovládací prvky, které spustit kód změnit dokumenty nebo zobrazit data ze zdroje dat.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v Outlooku 2013 a v Outlooku 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

[!POZNÁMKA]

Vlastní podokno úloh se liší v podokně Akce.V podokně akcí je součástí vlastní úroveň dokument pro aplikaci Microsoft Office Word a Microsoft Office Excel.Další informace naleznete v tématu Přehled podokna akcí.

Výhody vlastního podokna úloh

Vlastní podokna úloh umožňují integrovat funkce do přehledného uživatelského rozhraní.Vlastní podokno úloh lze rychle vytvořit pomocí nástroje Visual Studio.

Známé uživatelské rozhraní

Uživatelé aplikací systému Microsoft Office jsou již seznámeni s pomocí podokna úloh, jako styly a formátování podokno úloh v aplikaci Word.Vlastní podokna úloh se chovat jako ostatní podokna úloh v systému Microsoft Office.Uživatelům můžete ukotvit vlastní podokna úloh na různých stranách okna aplikace nebo jejich vlastní podokna úloh přetáhnout na libovolné místo v okně.Můžete vytvořit doplněk současně zobrazí více podoken úloh a uživatelé mohou řídit každý podokno úloh jednotlivě.

Podpora model Windows Forms

Uživatelské rozhraní vlastní podokno úloh, které vytvoříte pomocí nástroje pro vývoj Office v sadě Visual Studio je založena na model Windows Forms prvky.Můžete použít Návrháře známých model Windows Forms navrhovat uživatelské rozhraní pro vlastní podokno úloh.Můžete také podporu vazby dat v model Windows Forms zdroj dat svázat ovládací prvky na podokno úloh.

Vytvoření vlastní podokno úloh

Můžete vytvořit základní vlastní podokno úloh ve dvou krocích:

  1. Vytvoření uživatelského rozhraní pro vaše vlastní podokno úloh přidáním ovládacích prvků model Windows Forms UserControl objektu.

  2. Vytvořte instanci vlastního podokno úloh předáním uživatelského ovládacího prvku CustomTaskPaneCollection objektu v doplňku.Tato kolekce vrátí nový CustomTaskPane objekt, můžete změnit vzhled podokno úloh a reagovat na události uživatele.

Další informace naleznete v tématu Postupy: Přidání vlastního podokna úloh do aplikace.

Vytvoření uživatelského rozhraní

Obsahují všechny vlastní podokna úloh, které jsou vytvořeny pomocí nástroje pro vývoj Office v sadě Visual Studio UserControl objektu.Tento uživatelský ovládací prvek poskytuje uživatelské rozhraní vaší vlastní podokno úloh.Můžete vytvořit uživatelský ovládací prvek v době návrhu nebo za běhu.Pokud vytvoříte uživatelský ovládací prvek v době návrhu, můžete vytvořit uživatelské rozhraní aplikace podokno úloh model Windows Forms Návrhář.

Konkretizace vlastní podokno úloh

Po vytvoření uživatelského ovládacího prvku, který obsahuje uživatelské rozhraní pro vlastní podokno úloh je nutné vytvořit instanci CustomTaskPane.Postup předání uživatelského ovládacího prvku CustomTaskPaneCollection v doplňku voláním jedné z Add metod.Tato kolekce je vystavena jako CustomTaskPanes pole ThisAddIn třídy.Následující příklad kódu je určen ke spuštění z ThisAddIn třídy.

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True

myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

Add Metody vrátí nový CustomTaskPane objektu.Tento objekt můžete změnit vzhled podokno úloh a reagovat na události uživatele.

Podokno úloh ve více oknech řízení

Rámeček okna dokumentu, představuje zobrazení dokumentu nebo položky uživateli přidruženy vlastní podokna úloh.Podokno úloh je viditelné pouze okno přidružené viditelné.

Určit, které okno zobrazí vlastní podokno úloh, použijte příslušný Add přetížení metody při vytváření podokno úloh:

Některé aplikace sady Office vyžadují explicitní pokyny při vytvoření nebo zobrazení vaší podokno úloh při otevření více oken.Proto je důležité zvážit, kam chcete vytvořit instanci vlastního podokno úloh v kódu zajistit, aby se podokno úloh s příslušné dokumenty nebo položky v aplikaci.Další informace naleznete v Správa vlastních podoken aplikace systému Windows.

Přístup k aplikaci z podokna úloh

Pokud chcete automatizovat aplikace z uživatelského ovládacího prvku, můžete přístup objektový model přímo pomocí Globals.ThisAddIn.Application v kódu.Statické Globals třída poskytuje přístup ThisAddIn objektu.Application Pole tohoto objektu je vstupní bod do objektového modelu aplikace.

Další informace o Application pole ThisAddIn objekt, viz Programování doplňků na úrovni aplikace.Návod, který ukazuje, jak automatizovat aplikaci z vlastní podokno úloh, viz Návod: Automatizace aplikace z vlastního podokna úloh.Další informace o Globals třídy naleznete v tématu Globální přístup k objektům v projektech pro systém Office.

Správa uživatelského rozhraní podokna úloh

Po vytvoření podokno úloh můžete použít vlastnosti a události CustomTaskPane objekt ovládacího prvku uživatelského rozhraní podokno úloh a reagovat, když uživatel změní podokno úloh.

Zviditelnění vlastní podokno úloh

Ve výchozím nastavení není podokno úloh viditelná.Podokno úloh zviditelnit, je třeba nastavit Visible vlastnost true.

Uživatelé mohou klepnutím na tlačítko Zavřít podokno úloh kdykoli zavřete v podokno úloh rohu tlačítko (X).Je však žádný výchozí způsob znovu otevřít vlastní podokno úloh.Pokud uživatel zavře vlastní podokno úloh, že uživatel nemůže zobrazit vlastní podokno úloh znovu Pokud nestanoví způsob zobrazení.

Pokud vytvoříte vlastní podokno úloh doplněk, byste měli vytvořit prvek uživatelského rozhraní, například tlačítko, které mohou uživatelé klepnout a zobrazit nebo skrýt své vlastní podokno úloh.Pokud vytvoříte vlastní podokno úloh v aplikaci Microsoft Office, která podporuje vlastní nastavení pásu karet, můžete přidat skupinu ovládacího prvku na pásu karet se tlačítko zobrazí nebo skryje vaše vlastní podokno úloh.Návod, který demonstruje, jak to udělat naleznete v Návod: Synchronizace vlastního podokna úloh s tlačítkem na pásu karet.

Pokud vytvoříte vlastní podokno úloh v aplikaci Microsoft Office, která nepodporuje vlastní nastavení pásu karet, můžete přidat CommandBarButton , zobrazí nebo skryje vaše vlastní podokno úloh.

Změna vzhledu podokno úloh

Pomocí vlastností můžete řídit velikost a umístění vlastního podokno úloh CustomTaskPane objektu.Můžete provést mnoho změn vzhledu vlastní podokno úloh pomocí vlastnosti UserControl objekt, který je obsažen ve vlastní podokno úloh.Například můžete zadat obrázek pozadí pro vlastní podokno úloh pomocí BackgroundImage vlastnost uživatelského ovládacího prvku.

Následující tabulka uvádí změny lze provádět vlastní podokno úloh pomocí CustomTaskPane vlastnosti.

Úloha

Property

Změna velikosti podokno úloh

Height

Width

Změna umístění podokno úloh

DockPosition

Zviditelnit nebo skrýt podokno úloh

Visible

Chcete-li uživateli zabránit ve změně umístění podokno úloh

DockPositionRestrict

Události podokna úloh vlastní programování

Můžete chtít doplněk reagovat, pokud uživatel upraví vlastní podokno úloh.Například pokud uživatel změní orientaci v podokně ze svislé na vodorovnou, můžete změnit umístění ovládacích prvků.

Následující tabulka obsahuje události, které lze zpracovávat a reagovat na změny, které uživatel vlastní podokno úloh.

Úloha

Událost

Reagovat, pokud uživatel změní umístění podokno úloh.

DockPositionChanged

Reagovat při podokno úloh skryje nebo zobrazí ho.

VisibleChanged

Vyčištění prostředků používaných v podokně úloh

Po vytvoření vlastní podokno úloh, CustomTaskPane objekt zůstane v paměti jako doplněk spuštěn.Objekt zůstane v paměti i po kliknutí Zavřít v podokno úloh rohu tlačítko (X).

Slouží k vyčištění prostředků používaných podokno úloh při-v běhu, Remove nebo RemoveAt metod.Odebrat tyto metody zadané CustomTaskPane z objektu CustomTaskPanes kolekcí a jejich volání Dispose metoda objektu.

Visual Studio Tools for Office runtime Automaticky vyčistí prostředky používané vlastní podokno úloh-in je uvolněn.Nevolejte Remove nebo RemoveAt metod ThisAddIn_Shutdown obslužné rutiny události v projektu.Tyto metody vyvolají ObjectDisposedException, protože Visual Studio Tools for Office runtime vyčistí prostředky používané CustomTaskPane objekt před ThisAddIn_Shutdown je volána.Další informace o ThisAddIn_Shutdown, vizUdálosti v projektech pro systém Office

Správa vlastní podokna úloh v systému Windows více aplikací

Vytvořit vlastní podokno úloh v aplikaci, která používá více oken pro zobrazení dokumentů a dalších položek, potřebujete provést další kroky, aby podokno úloh viditelné při jeho očekává uživatel.

Rámeček okna dokumentu, představuje zobrazení dokumentu nebo položky uživateli přidruženy vlastní podokna úloh ve všech aplikacích.Podokno úloh je viditelné pouze okno přidružené viditelné.Však ne všechny aplikace pomocí systému windows rámeček dokument stejným způsobem.

Následující skupiny aplikace mají různé vývojové požadavky:

  • Aplikace Outlook

  • PowerPoint, Word a aplikace InfoPath

odkaz na video Související video ukázku naleznete v tématu Jak provést I: spravovat podokna úloh v aplikaci Word, doplňky?.

Aplikace Outlook

Při vytváření vlastní podokno úloh pro aplikaci Outlook je spojen s konkrétní okna Průzkumník nebo inspektor vlastní podokno úloh.Jsou v Průzkumníkovi windows, které zobrazují obsah složky a inspektoři jsou windows, které zobrazují položky, například e-mailové zprávy nebo úkolu.

Pokud chcete zobrazit vlastní podokno úloh systému windows více Průzkumník nebo inspektor, musíte vytvořit novou instanci vlastního podokno úloh otevře okno aplikace Průzkumník nebo inspektor.Zpracujte událost, která je vyvolána při vytvoření okna aplikace Průzkumník nebo inspektor a potom vytvořit podokno úloh v obslužné rutině události.Můžete také zpracovávat události Explorer a inspektor skrytí nebo zobrazení podoken úloh podle okna je zobrazen.

Podokno úloh přidružit konkrétní Průzkumník nebo inspektor, použít CustomTaskPaneCollection.Add(UserControl, String, Object) metodu k vytvoření podokno úloh a předat Explorer nebo Inspector objektu window parametr.Další informace o vytváření vlastní podokna úloh, viz Vlastní podokna úloh.

Návod, který ukazuje, jak vytvořit podokno úloh každé otevření e-mailové zprávy, viz Návod: Zobrazení vlastních podoken úloh s e-mailovými zprávami v aplikaci Outlook.

Události aplikace Outlook

Sledovat stav Průzkumníka windows, můžete zpracovávat následující události související s Explorer:

Sledování stavu inspektor windows, můžete zpracovávat následující události související se inspektor:

Zabránění více instancí vlastní podokno úloh v aplikaci Outlook

Zabránit zobrazení více instancí vlastní podokno úloh okna aplikace Outlook, explicitně odebrat vlastní podokno úloh z CustomTaskPanes kolekce ThisAddIn třídy při zavření okna.Volání Remove metodu v události, která je vyvolána při zavření okna, jako například ExplorerEvents_10_Event.Close nebo InspectorEvents_10_Event.Close.

Pokud vlastní podokno úloh není explicitně odebrat, okna aplikace Outlook může zobrazit více instancí vlastní podokno úloh.Outlook někdy recykluje windows a windows recyklovány zachovat odkazy na všechny vlastní podokna úloh, které byly připojeny k nim.

PowerPoint, Word a aplikace InfoPath

PowerPoint, Word a aplikace InfoPath zobrazí každý dokument v rámci okna jiného dokumentu.Při vytváření vlastní podokno úloh pro tyto aplikace je spojena pouze s konkrétní dokument vlastní podokno úloh.Pokud uživatel otevře jiný dokument, vlastní podokno úloh je skryt, dokud starší dokument je znovu zobrazen.

Pokud chcete zobrazit vlastní podokno úloh s více dokumenty, vytvořte novou instanci vlastního podokno úloh, když uživatel vytvoří nový dokument nebo otevře existující dokument.Zpracování událostí, které jsou vyvolány při vytvoření nebo otevření dokumentu a potom vytvořit podokno úloh v obslužné rutině události.Může také zpracovávat události dokumentu skrýt nebo zobrazit podokna úloh podle dokumentu, který je viditelný.

Přidružit podokno úloh okno určitého dokumentu, použijte CustomTaskPaneCollection.Add(UserControl, String, Object) metodu k vytvoření podokno úloh a předat Window (pro aplikaci Word) WindowObject (pro aplikaci InfoPath) nebo DocumentWindow (pro aplikaci PowerPoint) k window parametr.

Události aplikace Word

Sledování stavu systému windows dokumentu aplikace Word, můžete zpracovávat následující události:

Události aplikace InfoPath

Sledování stavu systému windows dokumentu v aplikaci InfoPath, můžete zpracovávat následující události:

Události aplikace PowerPoint

Sledování stavu systému windows dokumentu v aplikaci PowerPoint, můžete zpracovávat následující události:

Viz také

Úkoly

Postupy: Přidání vlastního podokna úloh do aplikace

Návod: Automatizace aplikace z vlastního podokna úloh

Návod: Synchronizace vlastního podokna úloh s tlačítkem na pásu karet

Návod: Zobrazení vlastních podoken úloh s e-mailovými zprávami v aplikaci Outlook