Personalizzazione di 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 2010 visualizzare la barra multifunzione interfaccia utente (UI) principale dell'applicazione e nelle finestre aperto quando gli utenti eseguono determinate attività, ad esempio creare messaggi di posta elettronica.Queste finestre dell'applicazione sono denominate controlli.

Per una dimostrazione video correlata, vedere How Do I: Use the Ribbon Designer to Customize the Ribbon in Outlook? (la pagina potrebbe essere in inglese).

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2013 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Aggiunta di una barra multifunzione personalizzata all'interfaccia utente principale dell'applicazione

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

Assegnazione di una barra multifunzione a un controllo

Identificare il controllo che si desidera personalizzare specificando il tipo di barra multifunzione corrispondente alla classe di messaggio per il controllo.

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

È possibile aggiungere più barre multifunzione a un progetto.Se più barre multifunzione condivide una barra multifunzione ID, eseguire l'override del metodo di CreateRibbonExtensibilityObject nella classe di ThisAddin del progetto specifica della barra multifunzione da visualizzare in fase di esecuzione.Per ulteriori informazioni, vedere Cenni preliminari sulla barra multifunzione.Per ulteriori informazioni su ogni tipo di barra multifunzione, vedere l'articolo tecnico personalizzare la barra multifunzione in Outlook 2007.

Specifica del tipo di barra multifunzione mediante l'elemento XML della barra multifunzione

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

Il metodo di GetCustomUI viene generato automaticamente da Visual Studio nel file di codice della barra multifunzione.Il parametro di ribbonID è una stringa che identifica Esplora Risorse o un tipo specifico di controllo.Per un elenco completo dei possibili valori del parametro ribbonID, vedere l'articolo tecnico Customizing the Ribbon in Outlook 2007 (informazioni in lingua inglese).

Nell'esempio di codice seguente viene illustrato come visualizzare una barra multifunzione personalizzata solo nel controllo di Microsoft.Outlook.Mail.Compose .Si tratta del controllo visualizzato quando un utente crea un nuovo messaggio di posta elettronica.La barra multifunzione da visualizzare viene specificata nel metodo di GetResourceText() , generato nella classe di Ribbon .Per ulteriori informazioni sulla classe Ribbon, vedere Elemento XML della barra multifunzione.

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;
}

Vedere anche

Concetti

Accesso alla barra multifunzione in fase di esecuzione

Finestra di progettazione della barra multifunzione

Elemento XML della barra multifunzione

Altre risorse

Cenni preliminari sulla barra multifunzione