Personalizzare una barra multifunzione per Outlook

Quando si personalizza la barra multifunzione in Microsoft Office Outlook, è necessario considerare la posizione in cui la barra multifunzione personalizzata verrà visualizzata nell'applicazione. Outlook visualizza la barra multifunzione nell'interfaccia utente principale dell'applicazione e nelle finestre aperte quando gli utenti eseguono determinate attività, ad esempio la creazione di messaggi di posta elettronica. Queste finestre dell'applicazione sono denominate controlli.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Outlook. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Aggiungere una barra multifunzione personalizzata all'interfaccia utente principale dell'applicazione

L'interfaccia utente principale in Outlook è denominata Explorer. Se si utilizza l'elemento Barra multifunzione (Progettazione visiva), è possibile aggiungere una barra multifunzione a Explorer facendo clic sulla proprietà RibbonType della barra multifunzione nella finestra Proprietà e quindi selezionando Microsoft.Outlook.Explorer.

Assegnare una barra multifunzione a un controllo

Per identificare il controllo che si vuole personalizzare, specificare il tipo di barra multifunzione corrispondente alla classe messaggio per il controllo.

Se si utilizza l'elemento Barra multifunzione (Progettazione visiva), fare clic sulla proprietà RibbonType della barra multifunzione nella finestra Proprietà e quindi selezionare uno o più ID barra multifunzione dall'elenco di valori.

È possibile aggiungere più barre multifunzione a un progetto. Se più barre multifunzione condividono uno stesso ID, eseguire l'override del metodo CreateRibbonExtensibilityObject nella classe ThisAddin del progetto per specificare la barra multifunzione da visualizzare in fase di esecuzione. Per altre informazioni, vedere Panoramica della barra multifunzione. Per altre informazioni su ogni tipo di barra multifunzione, vedere l'articolo tecnico Personalizzare la barra multifunzione in Outlook 2007.

Specificare il tipo di barra multifunzione tramite XML della barra multifunzione

Se si usa l'elemento Barra multifunzione (XML), controllare il valore del parametro ribbonID nel GetCustomUI metodo e restituire la barra multifunzione appropriata.

Il metodo GetCustomUI viene generato automaticamente da Visual Studio nel file di codice della barra multifunzione. Il parametro ribbonID è una stringa che identifica Explorer o un tipo specifico di controllo. Per un elenco completo dei possibili valori del parametro ribbonID , vedere l'articolo tecnico Personalizzare la barra multifunzione in Outlook 2007.

L'esempio di codice seguente illustra come visualizzare una barra multifunzione personalizzata solo nel controllo Microsoft.Outlook.Mail.Compose. Questo controllo viene visualizzato quando un utente crea un nuovo messaggio di posta elettronica. La barra multifunzione da visualizzare viene specificata nel GetResourceText() metodo , generato nella classe Ribbon . Per altre informazioni sulla classe Ribbon, vedere RIBBON XML.

C#

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

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

    return ribbonXML;
}

VB

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

Contenuto correlato

• Accedere alla barra multifunzione in fase di esecuzione
• Panoramica della barra multifunzione
• Finestra di progettazione della barra multifunzione
• Ribbon XML