Sdílet prostřednictvím


Vlastní podokna úloh

Podokna úloh jsou panely uživatelského rozhraní, které jsou obvykle ukotvené na jedné straně okna v aplikaci systém Microsoft Office. 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é spouštějí kód pro úpravu dokumentů nebo zobrazení dat ze zdroje dat.

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

Poznámka:

Vlastní podokno úloh se liší od podokna akcí. Podokno akcí je součástí přizpůsobení na úrovni dokumentu pro systém Microsoft Office Word a systém Microsoft Office Excel. Další informace najdete v tématu Přehled podokna Akce.

Výhody vlastních podoken úloh

Vlastní podokna úloh umožňují integrovat funkce do známého uživatelského rozhraní. Vlastní podokno úloh můžete rychle vytvořit pomocí nástrojů sady Visual Studio.

Známé uživatelské rozhraní

Uživatelé aplikací v systému systém Microsoft Office už znají používání podoken úloh, jako jsou styly a formátování podokna úloh ve Wordu. Vlastní podokna úloh se chovají stejně jako ostatní podokna úloh v systému systém Microsoft Office. Uživatelé můžou ukotvit vlastní podokna úloh na různé strany okna aplikace nebo mohou přetáhnout vlastní podokna úloh do libovolného umístění v okně. Můžete vytvořit doplněk VSTO, který současně zobrazuje několik vlastních podoken úloh a uživatelé můžou řídit každé podokno úloh jednotlivě.

Podpora formulářů Windows

Uživatelské rozhraní vlastního podokna úloh, které vytvoříte pomocí vývojových nástrojů Office v sadě Visual Studio, je založeno na ovládacích prvcích model Windows Forms. Pomocí známého návrháře model Windows Forms můžete navrhnout uživatelské rozhraní pro vlastní podokno úloh. Podporu datových vazeb můžete použít také v model Windows Forms k vytvoření vazby zdroje dat k ovládacím prvkům v podokně úloh.

Vytvoření vlastního podokna úloh

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

  1. Vytvořte uživatelské rozhraní pro vlastní podokno úloh přidáním ovládacích prvků model Windows Forms do objektuUserControl.

  2. Vytvořte instanci vlastního podokna úloh předáním uživatelského ovládacího prvku objektu v doplňku CustomTaskPaneCollection VSTO. Tato kolekce vrátí nový CustomTaskPane objekt, který můžete použít k úpravě vzhledu podokna úloh a odpovídání 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í

Všechna vlastní podokna úloh vytvořená pomocí vývojových nástrojů Office v sadě Visual Studio obsahují UserControl objekt. Tento uživatelský ovládací prvek poskytuje uživatelské rozhraní vlastního podokna úloh. Uživatelský ovládací prvek můžete vytvořit v době návrhu nebo v době běhu. Pokud vytváříte uživatelský ovládací prvek v době návrhu, můžete pomocí návrháře model Windows Forms vytvořit uživatelské rozhraní podokna úloh.

Vytvoření instance vlastního podokna úloh

Po vytvoření uživatelského ovládacího prvku, který obsahuje uživatelské rozhraní vlastního podokna úloh, musíte vytvořit instanci CustomTaskPane. Uděláte to tak, že předáte uživatelskému ovládacímu prvku v doplňku CustomTaskPaneCollection VSTO voláním jedné z Add metod. Tato kolekce je vystavena CustomTaskPanes jako 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 = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

Metody Add vrátí nový CustomTaskPane objekt. Pomocí tohoto objektu můžete upravit vzhled podokna úloh a reagovat na události uživatelů.

Řízení podokna úloh ve více oknech

Vlastní podokna úloh jsou přidružená k oknem rámečku dokumentu, které uživateli zobrazí zobrazení dokumentu nebo položky. Podokno úloh je viditelné jenom v případech, kdy je přidružené okno viditelné.

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

  • Chcete-li přidružit podokno úloh k aktivnímu okně, použijte metodu Add .

  • Chcete-li přidružit podokno úloh k dokumentu hostovanému zadaným oknem, použijte metodu Add .

    Některé aplikace Office lications vyžadují explicitní pokyny pro vytvoření nebo zobrazení podokna úloh, když je otevřeno více než jedno okno. Proto je důležité zvážit, kde vytvořit instanci vlastního podokna úloh v kódu, aby se zajistilo, že se podokno úloh zobrazí s příslušnými dokumenty nebo položkami v aplikaci. Další informace naleznete v tématu Správa vlastních podoken úloh v oknech aplikací.

Přístup k aplikaci z podokna úloh

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

Další informace o poli objektu ApplicationThisAddIn naleznete v tématu Program VSTO Doplňky. Návod, který ukazuje, jak automatizovat aplikaci z vlastního podokna úloh, naleznete v části Návod: Automatická aplikace z vlastního podokna úloh. Další informace o Globals třídě naleznete v tématu Globální přístup k objektům v projektech Office.

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

Po vytvoření podokna úloh můžete pomocí vlastností a událostí objektu CustomTaskPane řídit uživatelské rozhraní podokna úloh a reagovat, když uživatel změní podokno úloh.

Zobrazení vlastního podokna úloh

Ve výchozím nastavení není podokno úloh viditelné. Chcete-li podokno úloh zobrazit, je nutné nastavit Visible vlastnost na hodnotu true.

Uživatelé můžou podokno úloh kdykoli zavřít kliknutím na tlačítko Zavřít (X) v rohu podokna úloh. Neexistuje však výchozí způsob, jak uživatelé znovu otevřít vlastní podokno úloh. Pokud uživatel zavře vlastní podokno úloh, nemůže znovu zobrazit vlastní podokno úloh, pokud nezadáte způsob, jak ho zobrazit.

Pokud v doplňku VSTO vytvoříte vlastní podokno úloh, měli byste také vytvořit prvek uživatelského rozhraní, například tlačítko, na které můžou uživatelé kliknout a zobrazit nebo skrýt vlastní podokno úloh. Pokud v aplikaci systém Microsoft Office vytvoříte vlastní podokno úloh, které podporuje přizpůsobení pásu karet, můžete na pás karet přidat skupinu ovládacích prvků pomocí tlačítka, které zobrazí nebo skryje vaše vlastní podokno úloh. Návod, který ukazuje, jak to provést, naleznete v části Návod: Synchronizace vlastního podokna úloh s tlačítkem pásu karet.

Pokud vytvoříte vlastní podokno úloh v aplikaci systém Microsoft Office, která nepodporuje přizpůsobení pásu karet, můžete přidat CommandBarButton zobrazení nebo skrytí vlastního podokna úloh.

Úprava vzhledu podokna úloh

Velikost a umístění vlastního podokna úloh můžete řídit pomocí vlastností objektu CustomTaskPane . Vzhled vlastního podokna úloh můžete provést mnoha dalšími změnami pomocí vlastností UserControl objektu, který je součástí vlastního podokna úloh. Můžete například zadat obrázek pozadí pro vlastní podokno úloh pomocí BackgroundImage vlastnosti uživatelského ovládacího prvku.

Následující tabulka uvádí změny, které můžete provést v podokně vlastních úloh pomocí CustomTaskPane vlastností.

Úloha Vlastnost
Změna velikosti podokna úloh Height

Width
Změna umístění podokna úloh DockPosition
Skrytí podokna úloh nebo jeho zobrazení Visible
Chcete-li zabránit uživateli ve změně umístění podokna úloh DockPositionRestrict

Programování událostí vlastního podokna úloh

Doplněk VSTO může chtít, aby reagoval, když uživatel upraví vlastní podokno úloh. Pokud například uživatel změní orientaci podokna z svislého na vodorovný, můžete ovládací prvky přemístit.

Následující tabulka uvádí události, které můžete zpracovat, aby reagoval na změny, které uživatel provede v podokně vlastních úloh.

Úloha Událost
Pokud chcete odpovědět, když uživatel změní umístění podokna úloh. DockPositionChanged
Pokud chcete odpovědět, když uživatel skryje podokno úloh nebo ho zviditelní. VisibleChanged

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

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

Pokud chcete vyčistit prostředky používané v podokně úloh, zatímco je doplněk VSTO stále spuštěný, použijte Remove tyto metody RemoveAt . Tyto metody odeberou zadaný CustomTaskPane objekt z CustomTaskPanes kolekce a volají Dispose metodu objektu.

Visual Studio Tools for Office runtime automaticky vyčistí prostředky používané vlastním podoknem úloh při uvolnění doplňku VSTO. Nevolejte v projektu obslužnou rutinu RemoveThisAddIn_Shutdown události ani RemoveAt metody. Tyto metody vyvolá výjimku ObjectDisposedException, protože Visual Studio Tools for Office runtime vyčistí prostředky používané objektem CustomTaskPane před ThisAddIn_Shutdown zavoláním. Další informace o ThisAddIn_Shutdownakcích v projektech Office naleznete v tématu Události.

Správa vlastních podoken úloh v několika oknech aplikací

Při vytváření vlastního podokna úloh v aplikaci, která používá více oken k zobrazení dokumentů a dalších položek, musíte provést další kroky, abyste zajistili, že podokno úloh bude viditelné, když uživatel očekává, že bude.

Vlastní podokna úloh ve všech aplikacích jsou přidružená k oknem rámečku dokumentu, které uživateli zobrazí zobrazení dokumentu nebo položky. Podokno úloh je viditelné jenom v případech, kdy je přidružené okno viditelné. Ne všechny aplikace ale používají okna s rámečkem dokumentu stejným způsobem.

Následující skupiny aplikací mají různé požadavky na vývoj:

Outlook

Při vytváření vlastního podokna úloh pro Outlook je vlastní podokno úloh přidružené ke konkrétnímu okně Průzkumníka nebo inspektoru. Explorers are windows that display the contents of a folder, and Inspectors are windows that display an item such as an email message or a task.

Pokud chcete zobrazit vlastní podokno úloh s více okny Průzkumníka nebo inspektoru, musíte při otevření okna Průzkumníka nebo inspektoru vytvořit novou instanci vlastního podokna úloh. Uděláte to tak, že zpracujete událost vyvolanou při vytvoření okna Průzkumníka nebo inspektoru a pak v obslužné rutině události vytvořte podokno úloh. Můžete také zpracovat události Průzkumníka a inspektoru a skrýt nebo zobrazit podokna úloh v závislosti na tom, které okno je viditelné.

Chcete-li přidružit podokno úloh ke konkrétnímu Průzkumníkovi nebo inspektoru, použijte Add metodu k vytvoření podokna úloh a předejte Explorer objekt Inspector parametru okna . Další informace o vytváření vlastních podoken úloh naleznete v tématu Přehled vlastních podoken úloh.

Zabránění více instancím vlastního podokna úloh v Outlooku

Chcete-li zabránit, aby okna Aplikace Outlook zobrazovala více instancí vlastního podokna úloh, explicitně odeberte vlastní podokno úloh z CustomTaskPanes kolekce ThisAddIn třídy při zavření každého okna. Remove Volání metody v události, která je vyvolána při zavření okna, například Close nebo Close.

Pokud vlastní podokno úloh explicitně neodeberete, okna Outlooku můžou zobrazit více instancí vlastního podokna úloh. Outlook někdy recykluje okna a recyklovaná okna uchovávají odkazy na všechna vlastní podokna úloh, která k nim byla připojena.

Word, InfoPath a PowerPoint

Word, InfoPath a PowerPoint zobrazují každý dokument v jiném okně rámečku dokumentu. Při vytváření vlastního podokna úloh pro tyto aplikace je vlastní podokno úloh přidruženo pouze k určitému dokumentu. Pokud uživatel otevře jiný dokument, bude vlastní podokno úloh skryté, dokud se předchozí dokument znovu nezobrazí.

Pokud chcete zobrazit vlastní podokno úloh s více dokumenty, vytvořte novou instanci vlastního podokna úloh, když uživatel vytvoří nový dokument nebo otevře existující dokument. Uděláte to tak, že zpracujete události, které jsou vyvolány při vytvoření nebo otevření dokumentu, a pak v obslužných rutinách událostí vytvořte podokno úloh. Události dokumentu můžete také zpracovat a skrýt nebo zobrazit podokna úloh v závislosti na tom, který dokument je viditelný.

Chcete-li přidružit podokno úloh k určitému okně dokumentu, použijte Add metodu k vytvoření podokna úloh a předejte Window parametru okna (pro Aplikaci Word), WindowObject (pro InfoPath) nebo DocumentWindow (pro PowerPoint).

Události aplikace Word

Pokud chcete monitorovat stav oken dokumentů ve Wordu, můžete zpracovat následující události:

Události aplikace InfoPath

Pokud chcete monitorovat stav oken dokumentů v aplikaci InfoPath, můžete zpracovat následující události:

Události PowerPointu

Pokud chcete monitorovat stav oken dokumentů v PowerPointu, můžete zpracovat následující události: