Acessando 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 executar o código de controles em um painel de tarefas personalizado, o painel de ações ou a região de formulário do Outlook.
Você pode acessar a faixa de opções usando o Globals classe. Para projetos do Outlook, você pode acessar as faixas de opções que aparecem em uma janela de inspetor do Outlook ou o Outlook Explorer específica.
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 2007 e Excel 2010; InfoPath 2010; Outlook 2007 e Outlook 2010; PowerPoint 2007 e PowerPoint 2010; Project 2010; Visio 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.
Acessando a faixa de opções usando a classe de globais
Você pode usar o Globals a classe para acessar a faixa de opções em um projeto de nível de documento ou nível de aplicativo em qualquer lugar no project.
For more information about the Globals class, see Acesso global a objetos em projetos do Office.
O exemplo a seguir usa a Globals a classe para acessar uma faixa de opções personalizada denominada Ribbon1 e definir o texto que aparece em uma caixa de combinação da 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";
}
Acessar uma coleção de faixas de opções que aparecem em uma janela de Inspetor de propriedades específicas do Outlook
Você pode acessar uma coleção de faixas de opções que aparecem no Outlook Inspectors. Um inspetor é uma janela aberta no Outlook quando os usuários a realizar determinadas tarefas, como, por exemplo, criar mensagens de email. Para acessar a faixa de opções de uma janela Inspector, chamar o Ribbons propriedade da Globals de classe e passar um Inspector objeto que representa o Inspetor de propriedades.
O exemplo a seguir obtém a coleção de faixa de opções do Inspetor que atualmente tem foco. Este exemplo, em seguida, 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";
}
Acessar uma coleção de faixas de opções que aparecem para um navegador específico do Outlook
Você pode acessar uma coleção de faixas de opções que aparecem no Outlook Explorer. Um Explorer é a interface de usuário do aplicativo principal (UI) para uma instância do Outlook. Para acessar a faixa de opções de uma janela do Explorer, chamar o Ribbons propriedade da Globals de classe e passar um Explorer objeto que representa o Explorer.
O exemplo a seguir obtém a coleção de faixa do Explorer que atualmente tem foco. Este exemplo, em seguida, 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_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
Demonstra Passo a passo: Criando uma guia personalizada usando o designer de faixa de opções
Demonstra Passo a passo: A atualização de controles em uma faixa de opções em tempo de execução
Conceitos
Visão geral do modelo de objeto de faixa de opções
Acessar uma região de formulário em tempo de execução