Personalizzazione di una barra multifunzione per Outlook
Aggiornamento: novembre 2007
Si applica a |
|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto
Versione Microsoft Office
Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione. |
Quando si personalizza la barra multifunzione in Microsoft Office Outlook 2007, è necessario considerare la posizione in cui la barra multifunzione personalizzata verrà visualizzata nell'applicazione. In Outlook la barra multifunzione non viene visualizzata nell'interfaccia utente principale dell'applicazione, ma piuttosto 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.
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. I passaggi per specificare il tipo di barra multifunzione variano a seconda che si utilizzi la finestra di progettazione della barra multifunzione o l'elemento XML della barra multifunzione.
Utilizzo della finestra di progettazione della barra multifunzione
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).
Utilizzo dell'elemento XML della barra multifunzione
Se si utilizza l'elemento Barra multifunzione (XML), controllare il valore del parametro ribbonID nel metodo Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI e restituire la barra multifunzione appropriata.
Il metodo Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI viene generato automaticamente da Visual Studio Tools per Office nel file di codice della barra multifunzione. Il parametro ribbonID è una stringa che identifica 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
Cenni preliminari sulla barra multifunzione