Acessar a Faixa de Opções em tempo de execução

Você pode escrever código para mostrar, ocultar e modificar a Faixa de Opções e permitir que os usuários executem o código a partir de controles em um painel de tarefas personalizado, painel de ações ou região de formulário do Outlook.

Você pode acessar a Faixa de Opções usando a Globals classe. Para projetos do Outlook, você pode acessar as Faixas de Opções que aparecem em uma janela específica do Inspetor do Outlook ou do Outlook Explorer.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para os seguintes aplicativos: Excel; InfoPath 2013 e InfoPath 2010; Perspectiva; PowerPoint; Projeto; Visio; Palavra. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Acessar a Faixa de Opções usando a classe Globals

Você pode usar a classe para acessar a Globals Faixa de Opções em um projeto de nível de documento ou projeto de suplemento VSTO de qualquer lugar no projeto.

Para obter mais informações sobre a classe, consulte Acesso global a Globals objetos em projetos do Office.

O exemplo a seguir usa a Globals classe para acessar uma Faixa de Opções personalizada nomeada Ribbon1 e definir o texto que aparece em uma caixa de combinação na Faixa de Opções como Hello World.

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

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

Acessar uma coleção de Faixas de Opções que aparecem em uma janela específica do Inspetor do Outlook

Você pode acessar uma coleção de Faixas de Opções que aparecem nos Inspetores do Outlook. Um Inspetor é uma janela que se abre no Outlook quando os usuários executam determinadas tarefas, como a criação de mensagens de email. Para acessar a Faixa de Opções de uma janela do Inspetor, chame a Ribbons Globals propriedade da classe e passe um Inspector objeto que represente o Inspetor.

O exemplo a seguir obtém a coleção Ribbon do Inspector que atualmente tem foco. Este exemplo acessa uma Faixa de Opções nomeada Ribbon1 e define o texto que aparece em uma caixa de combinação na Faixa de Opções como Hello World.

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "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

Acessar uma coleção de Faixas de Opções que aparecem para um Outlook Explorer específico

Você pode acessar uma coleção de Faixas de Opções que aparecem em um Outlook Explorer. Um Explorer é a interface do usuário (UI) do aplicativo principal para uma instância do Outlook. Para acessar a Faixa de Opções de uma janela do Explorer, chame a Ribbons Globals propriedade da classe e passe um Explorer objeto que represente o Explorer.

O exemplo a seguir obtém a coleção Ribbon do Explorer que atualmente tem foco. Este exemplo acessa uma Faixa de Opções nomeada Ribbon1 e define o texto que aparece em uma caixa de combinação na Faixa de Opções como Hello World.

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "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

Conteúdo relacionado

• Visão geral da faixa de opções
• Designer da faixa de opções
• XML da faixa de opções
• Visão geral do modelo de objeto da faixa de opções
• Demonstra Passo a passo: Criar uma guia personalizada usando o Designer da Faixa de Opções
• Demonstra Passo a passo: Atualizar os controles em uma faixa de opções em tempo de execução
• Personalizar uma Faixa de Opções para Outlook
• Acessar uma região de formulário em tempo de execução