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

Artigo
08/25/2010

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.

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";
}