Přístup k pásu karet za běhu

Můžete napsat kód, který zobrazí, skryje a upraví pás karet a umožní uživatelům spouštět kód z ovládacích prvků v podokně vlastních úloh, podokně akcí nebo oblasti formuláře Outlooku.

K pásu karet se dostanete pomocí Globals třídy. U projektů Outlooku máte přístup k pásům karet, které se zobrazují v konkrétním okně Outlook Inspectoru nebo Průzkumníka Outlooku.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentů a projekty doplňků VSTO pro následující aplikace: Excel; InfoPath 2013 a InfoPath 2010; Aplikace outlook; Powerpoint; Projektu; Aplikace visio; Slovo. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Přístup k pásu karet pomocí třídy Globals

Třídu Globals můžete použít pro přístup k pásu karet v projektu na úrovni dokumentu nebo v projektu doplňku VSTO odkudkoli v projektu.

Další informace o Globals třídě naleznete v tématu Globální přístup k objektům v projektech Office.

Následující příklad používá Globals třídu pro přístup k vlastnímu pásu karet s názvem Ribbon1 a nastavte text, který se zobrazí v poli se seznamem na pásu karet na Hello World.

C#

private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

VB

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub

Přístup ke kolekci pásů karet, které se zobrazují v konkrétním okně Outlook Inspectoru

K kolekci pásů karet, které se zobrazují v inspektorech Outlooku, máte přístup. Inspektor je okno, které se otevře v Outlooku, když uživatelé provádějí určité úkoly, například vytváření e-mailových zpráv. Pokud chcete získat přístup k pásu karet okna inspektoru, zavolejte Ribbons vlastnost Globals třídy a předejte Inspector objekt, který představuje inspektor.

Následující příklad načte kolekci pásu karet inspektoru, která má aktuálně fokus. Tento příklad pak přistupuje k pásu karet s názvem Ribbon1 a nastaví text, který se zobrazí v poli se seznamem na pásu karet na Hello World.

C#

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

VB

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

Přístup ke kolekci pásů karet, které se zobrazí pro konkrétního Průzkumníka Outlooku

K kolekci pásů karet, které se zobrazují v Průzkumníku Outlooku, máte přístup. Průzkumník je hlavní uživatelské rozhraní aplikace pro instanci Outlooku. Pokud chcete získat přístup k pásu karet okna Průzkumníka, zavolejte Ribbons vlastnost Globals třídy a předejte Explorer objekt, který představuje Průzkumníka.

Následující příklad získá kolekci pásu karet Průzkumníka, který je aktuálně fokus. Tento příklad pak přistupuje k pásu karet s názvem Ribbon1 a nastaví text, který se zobrazí v poli se seznamem na pásu karet na Hello World.

C#

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

VB

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

Související obsah

• Přehled pásu karet
• Návrhář pásu karet
• Pás karet – XML
• Přehled objektového modelu pásu karet
• Návod: Vytvoření vlastní karty pomocí Návrháře pásu karet
• Návod: Aktualizace ovládacích prvků na pásu karet za běhu
• Přizpůsobení pásu karet pro Outlook
• Přístup k oblasti formuláře za běhu