Uzyskiwanie dostępu do wstążki w czasie wykonywania

Możesz napisać kod umożliwiający wyświetlanie, ukrywanie i modyfikowanie wstążki oraz umożliwianie użytkownikom uruchamiania kodu z kontrolek w niestandardowym okienku zadań, okienku akcji lub regionie formularza programu Outlook.

Dostęp do wstążki można uzyskać przy użyciu Globals klasy . W przypadku projektów programu Outlook można uzyskać dostęp do wstążek wyświetlanych w określonym oknie Inspektor programu Outlook lub Eksplorator programu Outlook.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla następujących aplikacji: Excel; InfoPath 2013 i InfoPath 2010; Programu outlook; Powerpoint; Projektu; Visio; Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Uzyskiwanie dostępu do wstążki przy użyciu klasy Globals

Możesz użyć Globals klasy , aby uzyskać dostęp do wstążki w projekcie na poziomie dokumentu lub w projekcie dodatku VSTO z dowolnego miejsca w projekcie.

Aby uzyskać więcej informacji na temat Globals klasy, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

W poniższym przykładzie Globals użyto klasy , aby uzyskać dostęp do niestandardowej wstążki o nazwie Ribbon1 i ustawić tekst wyświetlany w polu kombi na wstążce na wartość 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

Uzyskiwanie dostępu do kolekcji wstążek wyświetlanych w określonym oknie Inspektor programu Outlook

Dostęp do kolekcji wstążek wyświetlanych w inspektorach programu Outlook można uzyskać. Inspektor to okno otwierane w programie Outlook, gdy użytkownicy wykonują określone zadania, takie jak tworzenie wiadomości e-mail. Aby uzyskać dostęp do wstążki okna Inspektor, wywołaj Ribbons właściwość Globals klasy i przekaż Inspector obiekt reprezentujący inspektora.

Poniższy przykład pobiera kolekcję wstążki inspektora, który obecnie ma fokus. W tym przykładzie uzyskuje się dostęp do wstążki o nazwie Ribbon1 i ustawia tekst wyświetlany w polu kombi na wstążce na wartość 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

Uzyskiwanie dostępu do kolekcji wstążek wyświetlanych dla określonego Eksploratora programu Outlook

Dostęp do kolekcji wstążek wyświetlanych w Eksploratorze programu Outlook można uzyskać. Eksplorator to główny interfejs użytkownika aplikacji dla wystąpienia programu Outlook. Aby uzyskać dostęp do wstążki okna Eksploratora, wywołaj Ribbons właściwość Globals klasy i przekaż Explorer obiekt reprezentujący Eksploratora.

Poniższy przykład pobiera kolekcję wstążki Eksploratora, który ma obecnie fokus. W tym przykładzie uzyskuje się dostęp do wstążki o nazwie Ribbon1 i ustawia tekst wyświetlany w polu kombi na wstążce na wartość 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

Powiązana zawartość

• Omówienie wstążki
• Projektant wstążki
• XML — wstążka
• Omówienie modelu obiektów wstążki
• Przewodnik: tworzenie karty niestandardowej przy użyciu Projektant wstążki
• Przewodnik: aktualizowanie kontrolek na wstążce w czasie wykonywania
• Dostosowywanie wstążki dla programu Outlook
• Uzyskiwanie dostępu do regionu formularza w czasie wykonywania