Partilhar via


Acessando a faixa de opções em tempo de execução

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de documento

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • O Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode Gravar código para mostrar, ocultar e modificar a Faixa de Opções e permitem aos usuários executar o código de controles em um painel de tarefas Personalizar, painel de ações ou região de formulário do Outlook.

Você pode acessar a Faixa de Opções usando a classe Globals.Para projetos do Outlook, você pode acessar as faixas de opções que Aparecerr em janelas do inspetor do Outlook específicas.

Acessando a Faixa de Opções usando a classe de globais

Você pode usar a classe Globals para acessar a faixa de opções em um projeto de nível de documento ou projeto de aplicativo-nível de qualquer lugar no projeto.

For more information about the Globals class, see Global Acessar a objetos no Visual Studio Tools para projetos do Office.

O exemplo a seguir usa a classe Globals para acessar uma Faixa de Opções Personalizar chamada Ribbon1 e definir o texto que aparece em uma caixa de combinação na faixa de opções para 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";
}

Acessando uma coleção de faixas de opções no Outlook

Você pode acessar um coleção de faixas de opções que Aparecerr no Outlook Inspectors.Um Inspector é uma janela aberta no Outlook quando os usuários executar determinadas tarefas, como a criação de mensagens de email.Para acessar a faixa de opções de uma janela do inspetor, chame a propriedade Ribbons da classe Globals e passar em um objeto de Inspector que representa o Inspector.

O exemplo a seguir obtém a coleção da Faixa de Opções do Inspector que atualmente tem foco.Em seguida, este exemplo acessa uma faixa de opções denominada Ribbon1 e define o texto que aparece em uma caixa de combinação da faixa de opções para 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";
}

Consulte também

Tarefas

Demonstra Passo a passo: Criando um guia Personalizar usando o Designer de Faixa de Opções

Demonstra Passo a passo: Atualizar os controles em uma faixa de opções em tempo de execução

Conceitos

Visão geral da Faixa de Opções

Designer de Faixa de Opções

XML da Faixa de Opções

Visão geral do modelo de objeto da Faixa de Opções

Personalizando uma faixa de opções para Outlook

Acessando uma região de formulário em tempo de execução