Acesso a faixa de opções em tempo de execuçãoAccess the Ribbon at runtime

Você pode escrever código para mostrar, ocultar e modificar a faixa de opções e permitir que os usuários executar o código de controles em um painel tarefa personalizada, o painel de ações ou a região de formulário do Outlook.You can write code to show, hide, and modify the Ribbon, and enable users to run the code from controls in a custom task pane, actions pane, or Outlook form region.

Você pode acessar a faixa de opções usando a Globals classe.You can access the Ribbon by using the Globals class. Para projetos do Outlook, você pode acessar as faixas de opções que aparecem em uma janela do Inspetor do Outlook ou o Outlook Explorer específica.For Outlook projects, you can access the Ribbons that appear in a specific Outlook Inspector or Outlook Explorer window.

Aplica-se a: as informações neste tópico se aplicam ao documento-projetos e VSTO adicionar nível-em projetos para os seguintes aplicativos: Excel; O InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Projeto; Visio; Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Para obter mais informações, consulte recursos disponíveis por tipo de projeto e aplicativo do Office.For more information, see Features available by Office application and project type.

Acesso a faixa de opções usando a classe GlobalsAccess the Ribbon by using the Globals class

Você pode usar o Globals classe para acessar a faixa de opções em um projeto no nível do documento ou um projeto de suplemento do VSTO em qualquer lugar no projeto.You can use the Globals class to access the Ribbon in a document-level project or VSTO Add-in project from anywhere in the project.

Para obter mais informações sobre o Globals de classe, consulte Global de acesso a objetos em projetos do Office.For more information about the Globals class, see Global access to objects in Office projects.

O exemplo a seguir usa o Globals classe para acessar uma faixa de opções personalizada denominada Ribbon1 e defina o texto que aparece em uma caixa de combinação na faixa de opções para Hello World.The following example uses the Globals class to access a custom Ribbon named Ribbon1 and set the text that appears on a combo box on the Ribbon to Hello World.

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

Acessar uma coleção de faixas de opções que aparecem em uma janela específica do Inspetor do OutlookAccess a collection of Ribbons that appear in a specific Outlook Inspector window

Você pode acessar uma coleção de faixas de opções que aparecem no Outlook inspetores.You can access a collection of Ribbons that appear in Outlook Inspectors. Um inspetor é uma janela que é aberta no Outlook, quando os usuários executam determinadas tarefas, como a criação de mensagens de email.An Inspector is a window that opens in Outlook when users perform certain tasks, such as creating e-mail messages. Para acessar a faixa de opções de uma janela de Inspetor, chame o Ribbons propriedade do Globals classe e passar uma Microsoft.Office.Interop.Outlook.Inspector objeto que representa o Inspetor.To access the Ribbon of an Inspector window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Inspector object that represents the Inspector.

O exemplo a seguir obtém a coleção de faixa de opções do Inspetor que tem o foco no momento.The following example gets the Ribbon collection of the Inspector that currently has focus. Neste exemplo, em seguida, acessa uma faixa de opções chamada Ribbon1 e define o texto que aparece em uma caixa de combinação na faixa de opções para Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Acessar uma coleção de faixas de opções que aparecem para um navegador específico do OutlookAccess a collection of Ribbons that appear for a specific Outlook Explorer

Você pode acessar uma coleção de faixas de opções que aparecem no Outlook Explorer.You can access a collection of Ribbons that appear in an Outlook Explorer. Um Explorer é a interface do usuário principal do aplicativo (IU) para uma instância do Outlook.An Explorer is the main application user interface (UI) for an instance of Outlook. Para acessar a faixa de opções de uma janela do Explorer, chame o Ribbons propriedade do Globals classe e passar uma Microsoft.Office.Interop.Outlook.Explorer objeto que representa o Gerenciador.To access the Ribbon of an Explorer window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Explorer object that represents the Explorer.

O exemplo a seguir obtém a coleção de faixa de opções do Explorer que tem o foco no momento.The following example gets the Ribbon collection of the Explorer that currently has focus. Neste exemplo, em seguida, acessa uma faixa de opções chamada Ribbon1 e define o texto que aparece em uma caixa de combinação na faixa de opções para Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Consulte tambémSee also

Visão geral da faixa de opções Ribbon overview
Designer de faixa de opções Ribbon Designer
XML da faixa de opções Ribbon XML
Visão geral do modelo de objeto de faixa de opções Ribbon object model overview
Passo a passo: Criar uma guia personalizada usando o Designer de faixa de opções Walkthrough: Create a custom tab by using the Ribbon Designer
Passo a passo: Atualizar os controles em uma faixa de opções em tempo de execução Walkthrough: Update the controls on a Ribbon at runtime
Personalizar uma faixa de opções para Outlook Customize a Ribbon for Outlook
Acesso a uma região de formulário em tempo de execuçãoAccess a form region at runtime