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. In Outlook 2010 la barra multifunzione viene visualizzata nell'interfaccia utente principale dell'applicazione e nelle finestre che vengono aperte quando gli utenti eseguono determinate attività, ad esempio la creazione di messaggi di posta elettronica. Queste finestre dell'applicazione vengono denominate controlli. In Outlook 2007 vengono visualizzati solo i controlli della barra multifunzione.

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 2007 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 Barra multifunzione (finestra di progettazione visiva), è possibile aggiungere una barra multifunzione alla finestra di esplorazione facendo clic sulla proprietà RibbonType della barra multifunzione nella finestra Proprietà e selezionando Microsoft.Outlook.Explorer.

Assegnazione di una barra multifunzione a un controllo

Per identificare il controllo che si desidera personalizzare, specificare il tipo di barra multifunzione che corrisponde alla classe messaggio relativa al controllo.

Se si utilizza l'elemento Barra multifunzione (finestra di progettazione visiva), fare clic sulla proprietà RibbonType della barra multifunzione nella finestra 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 condividono uno stesso ID di barra, eseguire l'override del metodo CreateRibbonExtensibilityObject nella classe ThisAddin del progetto per specificare la 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 Customizing the Ribbon in Outlook 2007 (informazioni in lingua inglese).

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

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

Il metodo GetCustomUI(String) viene generato automaticamente da Visual Studio nel file di codice della barra multifunzione. Il parametro ribbonID è una stringa che identifica la finestra di esplorazione 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 riportato di seguito viene illustrato come visualizzare una barra multifunzione personalizzata solo nel controllo Microsoft.Outlook.Mail.Compose, ovvero il controllo che viene aperto quando un utente crea un nuovo messaggio di posta elettronica. La barra multifunzione da visualizzare viene specificata nel metodo GetResourceText(), generato nella classe 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