Compartilhar via


Personalizando uma faixa de opções para Outlook

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 aplicativo

Versão do Microsoft Office

  • Outlook 2007

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

Quando você Personalizar a Faixa de Opções no Microsoft Office Outlook 2007, você deve considerar onde a Faixa de Opções personalizada aparecerá no aplicativo.O Outlook não Exibir a Faixa de Opções na interface de usuário do aplicativo principal (UI).Em vez disso, o Outlook exibe a faixa de opções em janelas que Abrir quando os usuários executar determinadas tarefas, como a criação de mensagens de email.Essas janelas de aplicativo são denominadas Inspectors.

Atribuir uma faixa de opções a um Inspector

Você identificar o inspetor de que deseja personalizar, especificando o tipo de Faixa de Opções que corresponde à classe de mensagem para o Inspector.As etapas para especificar o tipo da faixa de opções dependem se você estiver usando o Designer de Faixa de Opções ou XML da Faixa de Opções.

Usando o Designer de Faixa de Opções

Se você estiver usando o item de da Faixa de Opções (Designer Visual), clique em RibbonType propriedade a Faixa de Opções na janela Properties e Selecionar um ou mais identificações de Faixa de Opções da lista de valores.

Você pode adicionar mais de uma faixa de opções em um projeto.Se mais de uma faixa de opções compartilhar uma ID da Faixa de Opções, Substituir o método CreateRibbonExtensibilityObject na classe ThisAddin do seu projeto para especificar qual Faixa de Opções para exibir em tempo de execução.

For more information, see Visão geral da Faixa de Opções.

Para obter mais informações sobre cada tipo de faixa de opções, consulte o artigo técnico Personalizando a Faixa de Opções no Outlook 2007.

Usando o XML da Faixa de Opções

Se você estiver usando o item de da Faixa de Opções (XML), Marcar o valor do parâmetro no método ribbonIDMicrosoft.Office.Core.IRibbonExtensibility.GetCustomUI e retornar a Faixa de Opções apropriada.

O método Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI é gerado automaticamente pelo Ferramentas do Visual Studio para o Office no arquivo de código da Faixa de Opções.O parâmetro ribbonID é uma Cadeia de Caracteres que identifica um tipo específico de inspetor.Para um Concluir lista dos possíveis valores do parâmetro ribbonID , consulte o artigo técnico Personalizando a Faixa de Opções no Outlook 2007.

O exemplo de código a seguir demonstra como exibir uma Faixa de Opções Personalizar somente em Microsoft.Outlook.Mail.Compose Inspector.Este é o inspetor que abre quando um usuário cria um Novo Email.A Faixa de Opções para exibir é especificada no método GetResourceText(), que é gerado na classe da Faixa de Opções.Para obter mais informações sobre a classe da Faixa de opções, consulte XML da Faixa de Opções.

Public Function GetCustomUI(ByVal ribbonID As String) As String _
    Implements Office.IRibbonExtensibility.GetCustomUI

    Dim ribbonXML As String = String.Empty

    If ribbonID = "Microsoft.Outlook.Mail.Compose" Then
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml")
    End If

    Return ribbonXML
End Function
public string GetCustomUI(string ribbonID)
{
    string ribbonXML = String.Empty;

    if (ribbonID == "Microsoft.Outlook.Mail.Compose")
    {
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
    }

    return ribbonXML;
}

Consulte também

Conceitos

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

Visão geral da Faixa de Opções

Designer de Faixa de Opções

XML da Faixa de Opções