Personnalisation d'un ruban pour Outlook
Lorsque vous personnalisez le ruban dans Microsoft Office Outlook, vous devez prendre en compte l'endroit où votre ruban personnalisé apparaîtra dans l'application. Outlook 2010 affiche le ruban dans l'interface utilisateur de l'application principale et dans les fenêtres qui s'ouvrent lorsque les utilisateurs effectuent certaines tâches, telles que la création de messages électroniques. Ces fenêtres d'application sont appelées Inspecteurs. Outlook 2007 affiche uniquement le ruban dans les inspecteurs.
.gif "lien vers la vidéo")
Pour une démonstration vidéo connexe, consultez Comment faire pour utiliser le Concepteur de ruban pour personnaliser le ruban dans Outlook ? (page éventuellement en anglais).
S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Outlook 2007 et Outlook 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.
Ajout d'un ruban personnalisé à l'interface utilisateur de l'application principale
L'interface utilisateur de l'application principale dans Outlook est appelée l'Explorateur. Si vous utilisez l'élément Ruban (Concepteur visuel), vous pouvez ajouter un ruban à l'Explorateur en cliquant sur la propriété RibbonType du ruban dans la fenêtre Propriétés, et en sélectionnant ensuite Microsoft.Outlook.Explorer.
Assignation d'un ruban à un Inspecteur
Pour identifier l'Inspecteur que vous souhaitez personnaliser, spécifiez le type de ruban qui correspond à la classe de message de l'Inspecteur.
Si vous utilisez l'élément Ruban (Concepteur visuel), cliquez sur la propriété RibbonType du ruban dans la fenêtre Propriétés, puis sélectionnez un ou plusieurs ID de ruban dans la liste de valeurs.
Vous pouvez ajouter plusieurs rubans à un projet. Si plusieurs rubans partagent un ID de ruban, substituez la méthode CreateRibbonExtensibilityObject dans la classe ThisAddin de votre projet pour spécifier le ruban à afficher au moment de l'exécution. Pour plus d'informations, consultez Vue d'ensemble du ruban. Pour plus d'informations sur les différents types de ruban, consultez l'article technique Personnalisation du ruban dans Outlook 2007.
Spécification du type de ruban à l'aide du code XML du ruban
Si vous utilisez l'élément Ruban (XML), vérifiez la valeur du paramètre ribbonID dans la méthode GetCustomUI(String) et retournez le ruban approprié.
La méthode GetCustomUI(String) est automatiquement générée par Visual Studio dans le fichier de code du ruban. Le paramètre ribbonID est une chaîne qui identifie l'Explorateur ou un type spécifique d'inspecteur. Pour obtenir la liste complète des valeurs possibles du paramètre ribbonID, consultez l'article technique Personnalisation du ruban dans Outlook 2007.
L'exemple de code suivant montre comment afficher un ruban personnalisé uniquement dans l'Inspecteur Microsoft.Outlook.Mail.Compose. C'est l'Inspecteur qui s'affiche lorsqu'un utilisateur crée un message électronique. Le ruban à afficher est spécifié dans la méthode GetResourceText(), générée dans la classe du ruban. Pour plus d'informations sur la classe du ruban, consultez Élément XML Ribbon.
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;
}
Voir aussi
Concepts
Accès au ruban au moment de l'exécution