Sdílet prostřednictvím

Přehled podokna Akcí

  • Článek

Podokno akcí je přizpůsobitelné podokno úloh Akce dokumentu, které je připojené k určitému systém Microsoft Office wordovém dokumentu nebo systém Microsoft Office excelového sešitu. Podokno akcí je hostované v podokně úloh Office spolu s dalšími předdefinovanými podokny úloh, jako je podokno úloh Zdroj XML v Excelu nebo podokno úloh Styly a formátování ve Wordu. K návrhu uživatelského rozhraní podokna akcí můžete použít model Windows Forms ovládací prvky nebo ovládací prvky WPF.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu pro Excel a Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Podokno akcí můžete vytvořit jenom v přizpůsobení na úrovni dokumentu pro Word nebo Excel. V doplňku VSTO nelze vytvořit podokno akcí. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Poznámka:

Podokno akcí se liší od vlastních podoken úloh. Vlastní podokna úloh jsou přidružená k aplikaci, nikoli ke konkrétnímu dokumentu. Vlastní podokna úloh můžete vytvořit v doplňcích VSTO pro některé systém Microsoft Office aplikace. Další informace naleznete v tématu Vlastní podokna úloh.

Zobrazení podokna akcí

Podokno akcí je reprezentováno ActionsPane třídou. Při vytváření projektu na úrovni dokumentu je instance této třídy k dispozici pro váš kód pomocí ActionsPane pole ThisWorkbook třídy (pro Excel) nebo ThisDocument (pro Word) ve vašem projektu. Pokud chcete zobrazit podokno akcí, přidejte do Controls vlastnosti ActionsPane pole ovládací prvek model Windows Forms. Následující příklad kódu přidá ovládací prvek pojmenovaný actions do podokna akcí.

this.ActionsPane.Controls.Add(actions);

Podokno akcí se zobrazí za běhu, jakmile do něj explicitně přidáte ovládací prvek. Po zobrazení podokna akcí můžete dynamicky přidávat nebo odebírat ovládací prvky v reakci na akce uživatele. Obvykle přidáte kód pro zobrazení podokna akcí v Startup obslužné rutině ThisDocument události nebo ThisWorkbook tak, aby podokno akcí bylo viditelné při prvním otevření dokumentu uživatelem. Můžete ale chtít zobrazit podokno akcí pouze v reakci na akci uživatele v dokumentu. Můžete například přidat kód do Click události ovládacího prvku v dokumentu.

Přidání více ovládacích prvků do podokna akcí

Když do podokna akcí přidáte více ovládacích prvků, měli byste ovládací prvky seskupit do uživatelského ovládacího prvku a pak do Controls vlastnosti přidat uživatelský ovládací prvek. Tento proces zahrnuje následující kroky:

  1. Vytvořte uživatelské rozhraní podokna akcí přidáním ovládacího prvku Podokna akcí nebo položky uživatelského ovládacího prvku do projektu. Obě tyto položky zahrnují vlastní třídu model Windows FormsUserControl. Ovládací prvek podokna Akcí a položky uživatelského ovládacího prvku jsou ekvivalentní. Jediným rozdílem je jejich název.

  2. Přidejte model Windows Forms ovládací prvky do UserControl návrháře nebo psaním kódu.

    Poznámka:

    Ovládací prvky WPF můžete také přidat do podokna akcí přidáním WPF UserControl do model Windows Forms UserControl. Další informace naleznete v tématu Použití ovládacích prvků WPF v řešeních Office.

  3. Přidejte instanci vlastního uživatelského ovládacího prvku do ovládacích prvků obsažených ThisWorkbook v ActionsPane poli třídy (pro Excel) nebo ThisDocument (pro Word) ve vašem projektu.

    Příklady, které tento proces demonstrují podrobněji, najdete v tématu Postupy: Přidání podokna akcí do wordových dokumentů nebo excelových sešitů.

Skrytí podokna akcí

ActionsPane I když třída má metodu Hide Visible a vlastnost, nelze odebrat podokno akcí z uživatelského rozhraní pomocí všech členů ActionsPane samotné třídy. Hide Volání metody nebo nastavení Visible vlastnosti na false skryje pouze ovládací prvky v podokně akcí; neskryje podokno úloh.

Pokud chcete podokno úloh v řešení skrýt, máte několik možností:

  • Ve Wordu Visible nastavte vlastnost objektu TaskPane , který představuje podokno úloh Akce dokumentu na false. Následující příklad kódu je určen ke spuštění z ThisDocument třídy v projektu.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • Pro Excel nastavte DisplayDocumentActionTaskPane vlastnost objektu Application na false. Následující příklad kódu je určen ke spuštění z ThisWorkbook třídy v projektu.

    this.Application.DisplayDocumentActionTaskPane = false;

  • Pro Word nebo Excel můžete případně nastavit Visible vlastnost panelu příkazů, který představuje podokno úloh na false. Následující příklad kódu je určený ke spuštění z ThisDocument projektu nebo ThisWorkbook třídy.

    this.Application.CommandBars["Task Pane"].Visible = false;

Vymazání podokna akcí při otevření dokumentu

Když uživatel uloží dokument, zatímco je podokno akcí viditelné, podokno akcí se zobrazí při každém otevření dokumentu bez ohledu na to, jestli podokno akcí obsahuje nějaké ovládací prvky. Pokud chcete určit, kdy se zobrazí, zavolejte Clear metodu ActionsPane pole v Startup obslužné rutině ThisDocument události nebo ThisWorkbook zajistěte, aby podokno akcí při otevření dokumentu nebylo viditelné.

Určení, kdy je podokno akcí zavřené

Při zavření podokna akcí není vyvolána žádná událost. ActionsPane I když třída má VisibleChanged událost, tato událost není vyvolána, když koncový uživatel zavře podokno akcí. Místo toho je tato událost vyvolána, když ovládací prvky v podokně akcí jsou skryty voláním Hide metody nebo nastavením Visible vlastnosti na false.

Když uživatel podokno akcí zavře, uživatel ho může znovu zobrazit provedením jednoho z následujících postupů v uživatelském rozhraní aplikace.

Zobrazení podokna akcí pomocí uživatelského rozhraní Wordu nebo Excelu

  1. Na pásu karet klikněte na kartu Zobrazení .

  2. Ve skupině Zobrazit nebo skrýt klikněte na přepínač Akce dokumentu.

Události podokna Akcí programu

Do podokna akcí můžete přidat více uživatelských ovládacích prvků a pak napsat kód pro reakci na události v dokumentu zobrazením a skrytím uživatelských ovládacích prvků. Pokud namapujete elementy schématu XML do dokumentu, můžete v podokně akcí zobrazit určité uživatelské ovládací prvky vždy, když je kurzor uvnitř některého z elementů XML. Další informace naleznete v tématu Postupy: Mapování schémat na wordové dokumenty v sadě Visual Studio a Postupy: Mapování schémat na listy v sadě Visual Studio.

Můžete také napsat kód pro reakci na události jakéhokoli objektu, včetně řízení hostitele, aplikace nebo událostí dokumentu. Další informace naleznete v tématu Návod: Program proti událostem ovládacího prvku NamedRange.

Vytvoření vazby dat k ovládacím prvkům v podokně akcí

Ovládací prvky v podokně akcí mají stejné možnosti datové vazby jako ovládací prvky v model Windows Forms. Ovládací prvky můžete svázat se zdroji dat, jako jsou datové sady, typové datové sady a XML. Další informace najdete v tématu Datové vazby a model Windows Forms.

Ovládací prvky v podokně akcí a ovládacích prvcích v dokumentu můžete svázat se stejnou datovou sadou. Můžete například vytvořit vztah předlohy/podrobností mezi ovládacími prvky v podokně akcí a ovládacími prvky na listu. Další informace naleznete v tématu Návod: Vytvoření vazby dat k ovládacím prvkům v podokně akcí aplikace Excel.

Ověření dat v ovládacích prvcích podokna akcí

Pokud v podokně akcí zobrazíte pole zprávy v Validating obslužné rutině události ovládacího prvku, může být událost vyvolána podruhé, když se fokus přesune z ovládacího prvku do pole zprávy. Chcete-li zabránit tomuto problému, použijte ErrorProvider ovládací prvek k zobrazení všech chybových zpráv ověření.

Pořadí vytváření zásobníků uživatelských ovládacích prvků

Pokud používáte více uživatelských ovládacích prvků, můžete napsat kód pro správné naskládání uživatelských ovládacích prvků v podokně akcí bez ohledu na to, jestli je ukotven svisle nebo vodorovně. Pořadí vytváření zásobníků uživatelských ovládacích prvků v podokně akcí můžete nastavit pomocí StackStyle výčtu StackOrder vlastnosti. Další informace naleznete v tématu Postupy: Správa rozložení ovládacích prvků v podoknech akcí.

Vlastnost StackOrder může mít následující StackStyle hodnoty výčtu.

Styl stackingu Definice
ZBottom Stack from the bottom of the actions pane.
Pochází zLeft Stack from the left of the actions pane.
FromRight Stack from the right of the actions pane.
Odtop Stack from the top of the actions pane.
Nic Není definováno žádné pořadí skládání; pořadí řídí vývojář.

Následující kód nastaví StackOrder vlastnost pro naskládání uživatelských ovládacích prvků z horní části podokna akcí.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Ukotvení ovládacích prvků

Pokud uživatel změní velikost podokna akcí za běhu, ovládací prvky můžou změnit velikost podokna akcí. Vlastnost ovládacího prvku model Windows Forms můžete použít Anchor k ukotvení ovládacích prvků do podokna akcí. Ovládací prvky model Windows Forms můžete také ukotvit na uživatelský ovládací prvek stejným způsobem. Další informace naleznete v tématu Postupy: Ukotvení ovládacích prvků na model Windows Forms.

Změna velikosti podokna akcí

Velikost objektu ActionsPane nelze přímo změnit, protože ActionsPane je vložen v podokně úloh. Šířku podokna úloh však můžete změnit prostřednictvím kódu programu nastavením Width vlastnosti CommandBar , která představuje podokno úloh. Výšku podokna úloh můžete změnit, pokud je ukotvený vodorovně nebo plovoucí.

Změna velikosti podokna úloh prostřednictvím kódu programu se nedoporučuje, protože uživatel by měl mít možnost vybrat velikost podokna úloh, která nejlépe vyhovuje jejich potřebám. Pokud ale musíte změnit šířku podokna úloh, můžete k dosažení této úlohy použít následující kód.

this.CommandBars["Task Pane"].Width = 200;

Změna umístění podokna akcí

Nelze přímo přemístit ActionsPane umístění, protože je vloženo v podokně úloh. Podokno úloh však můžete programově přesunout nastavením Position vlastnosti CommandBar , která představuje podokno úloh.

Umístění podokna úloh prostřednictvím kódu programu se nedoporučuje, protože uživatel by měl mít možnost zvolit umístění podokna úloh na obrazovce, které nejlépe vyhovuje jeho potřebám. Pokud ale musíte podokno úloh přesunout na konkrétní pozici, můžete k dosažení této úlohy použít následující kód.

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Poznámka:

Koncoví uživatelé můžou podokno úloh kdykoli ručně přemístit. Neexistuje způsob, jak zajistit, aby podokno úloh zůstalo ukotvené na pozici, kterou označíte programově. Můžete ale zkontrolovat změny orientace a zajistit, aby ovládací prvky v podokně akcí byly skládané správným směrem. Další informace naleznete v tématu Postupy: Správa rozložení ovládacích prvků v podoknech akcí.

Top Nastavení a Left vlastností ActionsPane objektu se nezmění, protože ActionsPane objekt je vložený do podokna úloh.

Pokud podokno úloh není ukotvené, můžete nastavit Top vlastnosti Left CommandBar podokna úloh, které představuje podokno úloh. Následující kód přesune nečinné podokno úloh do levého horního rohu dokumentu.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Související obsah