Přehled podokna akcí

Článek
05/16/2015

Podokno akcí aplikace je vlastní Akce dokumentu podokno úloh připojené k konkrétní dokument Microsoft Office Word nebo sešit aplikace Microsoft Office Excel.Je umístěn uvnitř podokno úloh Office s další vestavěné podoken, jako Zdroj XML podokno úloh v aplikaci Excel nebo styly a formátování podokno úloh v aplikaci Word.Můžete navrhnout uživatelské rozhraní podokna akcí model Windows Forms prvky nebo prvky WPF.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v těchto aplikacích: Excel 2013 a Excel 2010; Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Podokno akcí aplikace lze vytvářet pouze v přizpůsobení úroveň dokument aplikace Word nebo Excel.Podokno akcí aplikace nelze vytvořit v doplňku úrovni aplikace.Další informace naleznete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

[!POZNÁMKA]

V podokně Akce se liší od vlastní podokna úloh.Vlastní podokna úloh jsou přidruženy k aplikaci určitého dokumentu.Můžete vytvořit vlastní podokna úloh v úrovni aplikace doplňky pro některé aplikace Microsoft Office.Další informace naleznete v tématu Vlastní podokna úloh.

odkaz na video Související video ukázku naleznete v tématu Jak provést i použití WPF ovládací prvky uvnitř aplikace Excel akce podokno?.

Zobrazení podokna akcí

V podokně akcí je reprezentován ActionsPane třídy.Při vytváření projektu úrovni dokumentu instance této třídy je k dispozici kódu pomocí ActionsPane pole ThisWorkbook (pro Excel) nebo ThisDocument (Word) tříd v projektu.Zobrazit podokno akcí, přidání ovládacího prvku model Windows Forms Controls vlastnost ActionsPane pole.Následující příklad kódu přidá ovládací prvek s názvem actions v podokně akcí.

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

V podokně akce viditelná v době běhu jako explicitně přidat ovládací prvek na něj.Po zobrazení v podokně akcí můžete dynamicky přidat nebo odebrat ovládací prvky v reakci na akce uživatele.Obvykle přidáte kód k zobrazení v podokně Akce Startup obslužné rutiny ThisDocument nebo ThisWorkbook tak, aby je zobrazen v podokně akcí při prvním otevření dokumentu.Můžete však zobrazit podokno akcí pouze v reakci na akce uživatele v dokumentu.Například můžete přidat kód Click události ovládacího prvku v dokumentu.

Přidání více ovládacích prvků v podokně akcí

Přidání více ovládacích prvků v podokně akcí ve většině případů by skupiny ovládací prvky v uživatelském ovládacím prvku ale přidejte uživatelský ovládací prvek Controls vlastnost.Tento proces zahrnuje následující kroky:

Vytvořit uživatelské rozhraní (UI) v podokně akcí přidáním Ovládací prvek podokna akcí nebo Uživatelský ovládací prvek položku v projektu.Obě tyto položky zahrnout vlastní model Windows Forms UserControl třídy.Ovládací prvek podokna akcí a Uživatelský ovládací prvek položky jsou rovnocenné; jediným rozdílem je jejich název.
Přidat ovládací prvky model Windows Forms a UserControl pomocí návrháře nebo psaní kódu.

[!POZNÁMKA]

Ovládacích prvků WPF v podokně akcí můžete přidat také přidáním WPF UserControl na model Windows Forms UserControl.Další informace naleznete v tématu Použití ovládacích prvků WPF v řešeních pro systém Office.
Přidat ovládací prvky, které jsou obsaženy v instanci vlastního uživatelského ovládacího prvku ActionsPane pole ThisWorkbook (pro Excel) nebo ThisDocument (Word) tříd v projektu.

Příklady, které ukazují tento proces podrobněji, viz Postupy: Přidání podokna akcí do dokumentů aplikace Word nebo sešitů aplikace Excel.

Skrytí podokna akcí

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

Skrýt podokno úloh ve vašem řešení, máte několik možností:

Word nastavit Visible vlastnost TaskPane objekt, který představuje akce dokumentu podokno úloh na false.Následující příklad kódu je určen ke spuštění z ThisDocument tříd v projektu.
```
Me.Application.TaskPanes(Word.WdTaskPanes.wdTaskPaneDocumentActions).Visible = False
```
```
this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
```
V aplikaci Excel nastavit DisplayDocumentActionTaskPane vlastnost Application objektu false.Následující příklad kódu je určen ke spuštění z ThisWorkbook tříd v projektu.
```
Me.Application.DisplayDocumentActionTaskPane = False
```
```
this.Application.DisplayDocumentActionTaskPane = false;
```
Aplikace Word nebo Excel můžete také nastavit CommandBar.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 nebo ThisWorkbook tříd v projektu.
```
Me.Application.CommandBars("Task Pane").Visible = False
```
```
this.Application.CommandBars["Task Pane"].Visible = false;
```

Zrušení akce podokno když dokument je otevřen.

Pokud uživatel uloží dokument je zobrazen v podokně Akce, v podokně akcí je viditelný při každém otevření dokumentu, zda podokno akcí obsahuje všechny ovládací prvky.Pokud chcete ovládací prvek když se objeví Clear metoda ActionsPane v Startup obslužné rutiny ThisDocument nebo ThisWorkbook tak, aby v podokně akcí není viditelná při otevření dokumentu.

Určení, pokud podokně akce je uzavřen.

Není žádná událost, která je vyvolána při zavření podokna akcí.Přestože ActionsPane třída má VisibleChanged událost, tato událost není aktivována při zavření podokna akcí.Tato událost je vyvolána, když jsou ovládací prvky v podokně Akce skrytý voláním Hide metoda nebo nastavením Visible vlastnost false.

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

Zobrazit podokno akcí pomocí uživatelského rozhraní aplikace Word nebo Excel

Na pásu karet klepněte zobrazení kartu.
V Zobrazit nebo skrýt skupinu, klepněte Akce dokumentu přepínací tlačítko.

Programování události podokno akcí

Můžete přidat více uživatelských ovládacích prvků v podokně Akce a poté napsat kód skrytím uživatelské ovládací prvky a reagovat na události v dokumentu.Pokud mapování prvků schématu XML v dokumentu, můžete zobrazit určité uživatelské ovládací prvky v podokně akce vždy, když je kurzor uvnitř jednoho z prvků XML.Další informace naleznete v tématu Postupy: Mapování schémat na dokumenty aplikace Word v prostředí Visual Studio a Postupy: Mapování schémat na listy v prostředí Visual Studio.

Můžete také napsat kód reagovat na události objektu, včetně hostitelského ovládacího prvku, aplikace nebo události dokumentu.Další informace získáte v tématu Návod: Programové ošetření událostí ovládacího prvku NamedRange.

Navázání dat na ovládací prvky v podokně Akce

Ovládací prvky v podokně akcí mají stejné možnosti vazby dat jako ovládací prvky na model Windows Forms.Můžete svázat ovládací prvky zdroje dat sady dat, typových datových sad a XML.Další informace naleznete v tématu Datové vazby a rozhraní Windows Forms.

Můžete svázat ovládací prvky v podokně akcí a na dokument stejného objektu dataset.Můžete například vytvořit vztah seznam–podrobnosti mezi ovládacími prvky v podokně akcí a ovládací prvky v listu.Další informace naleznete v tématu Návod: Svázání dat s ovládacími prvky v podokně akcí aplikace Excel.

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

Pokud se zobrazí v okně se zprávou Validating obslužnou rutinu události ovládacího prvku v podokně Akce událost může být vyvolána podruhé při přesunu fokusu z ovládacího prvku pole zpráva.K tomuto problému zabránit, použijte ErrorProvider ovládací prvek zobrazí všechny chybové zprávy ověřování.

Pořadí překrývání uživatelského ovládacího prvku

Pokud používáte více uživatelských ovládacích prvků, můžete napsat kód správně zásobníku uživatelské ovládací prvky v podokně akcí, zda je ukotveny svisle nebo vodorovně.Pořadí ovládacích prvků v podokně akcí můžete nastavit pomocí StackStyle výčet StackOrder vlastnost.Další informace naleznete v tématu Postupy: Správa rozložení ovládacích prvků v podoknech akcí

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

Překrývání styl	Definice
FromBottom	Zásobník v dolní části podokna akcí.
FromLeft	Zásobník v levé části podokna akcí.
FromRight	Zásobník v pravém podokně Akce.
FromTop	Zásobník z horní části podokna akcí.
None	Žádné pořadí překrývání definované; pořadí je řízena vývojář.

Následující kód nastaví StackOrder vlastnost zásobníku uživatelské ovládací prvky v horní části podokna akcí.

Me.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop

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

Ukotvení ovládacích prvků

Pokud uživatel změní velikost podokna akce za běhu, ovládací prvky můžete změnit velikost podokna akcí.Můžete použít Anchor vlastnost ovládacího prvku model Windows Forms ovládacích prvků ukotvení podokna akcí.Stejným způsobem můžete také ukotvit model Windows Forms ovládacích prvků do uživatelského ovládacího prvku.Další informace naleznete v tématu Postupy: Ukotvování ovládacích prvků ve Windows Forms.

Změna velikosti podokna akcí

Nelze přímo změnit velikost ActionsPane protože ActionsPane je vložený v podokno úloh.Však můžete programově změnit šířku podokno úloh nastavením Width vlastnost CommandBar podokno úloh, která představuje.Výška podokno úloh můžete změnit, pokud je umístěn vodorovně nebo plovoucí.

Programové změny velikosti podokno úloh obecně nedoporučuje, protože uživatel moci vybrat velikost podokno úloh, která nejlépe vyhovuje jeho potřebám.Však při změně velikosti šířka podokno úloh, můžete použít následující kód k dosažení tohoto úkolu.

Me.CommandBars("Task Pane").Width = 200

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

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

Nelze přemístit přímo ActionsPane protože je vložena do podokno úloh.Však můžete programově přesunout podokno úloh nastavením Position vlastnost CommandBar podokno úloh, která představuje.

Přemístění programově podokno úloh obecně nedoporučuje, protože uživatel moci vybrat podokno úloh pozici na obrazovce, která nejlépe vyhovuje jeho potřebám.Však Pokud podokno úloh musíte přesunout na konkrétní místo, můžete použít následující kód k dosažení tohoto úkolu.

Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft

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

[!POZNÁMKA]

Koncovým uživatelům lze ručně přemístit podokno úloh kdykoli.Neexistuje žádný způsob, jak zajistit, že podokno úloh zůstane ukotvený na pozici, kterou označíte programově.Můžete však zkontrolovat změny orientace a zajistit, že jsou ovládací prvky v podokně akcí 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í.

Nastavení Top a Left vlastnosti ActionsPane nezmění jeho pozici, protože ActionsPane v podokno úloh je vložený objekt.

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

If Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating Then 

    Me.CommandBars("Task Pane").Top = 0
    Me.CommandBars("Task Pane").Left = 0

End If

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

Viz také

Sdílet prostřednictvím