Compartilhar via


Personalizar uma faixa de opções para o Outlook

Ao personalizar a faixa de opções no Microsoft Office Outlook, você deve considerar onde a faixa de opções personalizada aparecerá no aplicativo. O Outlook exibe a faixa de opções na interface do usuário (UI) do aplicativo principal e em janelas que são abertas quando os usuários executam determinadas tarefas, como a criação de mensagens de email. Essas janelas de aplicativo são chamadas de inspetores.

Aplica-se a: As informações neste tópico se aplicam a projetos de suplemento VSTO para Outlook. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Adicionar uma faixa de opções personalizada à interface do usuário do aplicativo principal

A interface do usuário do aplicativo principal no Outlook é chamada de Explorer. Se você estiver usando o item Faixa de Opções (Visual Designer), poderá adicionar uma faixa de opções ao Explorer clicando na propriedade RibbonType da faixa de opções na janela Propriedades e selecionando Microsoft.Outlook.Explorer.

Atribuir uma faixa de opções a um inspetor

Você identifica o inspetor que deseja personalizar especificando o tipo de faixa de opções que corresponde à classe de mensagem do Inspetor.

Se você estiver usando o item Faixa de Opções (Visual Designer), clique na propriedade RibbonType da faixa de opções na janela Propriedades e selecione uma ou mais IDs da faixa de opções na lista de valores.

Você pode adicionar mais de uma faixa de opções a um projeto. Se mais de uma faixa de opções compartilhar uma ID da faixa de opções, substitua ThisAddin o CreateRibbonExtensibilityObject método na classe do seu projeto para especificar qual faixa de opções exibir em tempo de execução. Para obter mais informações, consulte 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 Personalizar a Faixa de Opções no Outlook 2007.

Especificar o tipo da faixa de opções usando XML da faixa de opções

Se você estiver usando o item Faixa de Opções (XML), verifique o valor do parâmetro ribbonID no GetCustomUI método e retorne a faixa de opções apropriada.

O GetCustomUI método é gerado automaticamente pelo Visual Studio no arquivo de código da faixa de opções. O parâmetro ribbonID é uma cadeia de caracteres que identifica o Explorer ou um tipo específico de inspetor. Para obter uma lista completa dos valores possíveis do parâmetro ribbonID , consulte o artigo técnico Personalizar a Faixa de Opções no Outlook 2007.

O exemplo de código a seguir demonstra como exibir uma faixa de opções personalizada somente no Microsoft.Outlook.Mail.Compose inspetor. Este é o inspetor que é aberto quando um usuário cria uma nova mensagem de email. A faixa de opções a ser exibida é especificada no GetResourceText() método, que é gerado na classe Ribbon . Para obter mais informações sobre a classe Ribbon , consulte XML da Faixa de Opções.

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

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

    return ribbonXML;
}