Partilhar via


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

Você pode escrever código para a apresentação, ocultar, e altere a fita, e permite que os usuários para executar o código de controles em um painel de tarefa personalizada, no painel ações, ou no formulário do Outlook região.

você pode acessar a fita usando a classe de Globals .Para projetos do Outlook, você pode acessar as fitas que aparecem em uma janela específica de inspector do Outlook ou do Outlook Explorer.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2013 e Excel 2010; InfoPath 2013 e InfoPath 2010; Outlook 2013 e Outlook 2010; PowerPoint 2013 e PowerPoint 2010; Project 2013 e Project 2010; Visio 2013 e Visio 2010; Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Acessando a fita usando a classe Globals

Você pode usar a classe de Globals para acessar dentro a fita em um projeto de um documento ou nível do projeto do nível em qualquer lugar do projeto.

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

O exemplo seguinte usa a classe de Globals para acessar uma fita personalizada chamada Ribbon1 e definir o texto que aparece em uma caixa de combinação em fita a 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 fitas que aparecem em uma janela específica do Outlook de inspector

Você pode acessar uma coleção de fitas que aparecem em inspectoresdo Outlook.Um inspector é uma janela que abre no Outlook quando os usuários executarem determinadas tarefas, como a criação de mensagens de email.Para acessar a fita de uma janela de inspector, chame a propriedade de Ribbons da classe de Globals e passar em um objeto de Inspector que representa inspector.

O exemplo a seguir obtém a coleção de fita de que inspector atualmente tem o foco.Este exemplo então acessa uma fita chamada Ribbon1 e define o texto que aparece em uma caixa de combinação em fita a 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";
}

Acessando uma coleção de fitas que aparecem para Outlook específico Explorer

Você pode acessar uma coleção de fitas que aparecem no Outlook Explorer.Explorer é a interface de usuário (UI) do aplicativo principal para uma instância do Outlook.Para acessar a fita de uma janela do Explorer, chame a propriedade de Ribbons da classe de Globals e passar em um objeto de Explorer que representa Explorer.

O exemplo a seguir obtém a coleção de fita de Explorer que atualmente tem o foco.Este exemplo então acessa uma fita chamada Ribbon1 e define o texto que aparece em uma caixa de combinação em fita a 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ém

Tarefas

Passo a passo: Criando uma guia personalizada usando o Designer de faixa de opções

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

Conceitos

Designer de faixa de opções

Faixa de opções XML

Visão geral do modelo de objeto de faixa de opções

Personalizando uma faixa de opções para o Outlook

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

Outros recursos

Visão geral da faixa de opções