Personnalisation d'un ruban pour Outlook
Mise à jour : novembre 2007
S'applique à |
|---|
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et aux versions de Microsoft Office spécifiés. Type de projet
Version de Microsoft Office
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
Lorsque vous personnalisez le ruban dans Microsoft Office Outlook 2007, vous devez prendre en compte l'endroit où votre interface utilisateur du ruban personnalisée apparaîtra dans l'application. Outlook n'affiche pas le ruban dans l'interface utilisateur de l'application principale. Outlook affiche le ruban dans des fenêtres qui s'ouvrent lorsque les utilisateurs exécutent certaines tâches, telles que la création de messages électroniques. Ces fenêtres d'application sont appelées Inspecteurs.
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. Les étapes de spécification du type de ruban dépendent de l'utilisation du Concepteur de ruban ou de l'élément XML Ruban.
Utilisation du Concepteur de ruban
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.
Utilisation de l'élément XML Ruban
Si vous utilisez l'élément Ruban (XML), vérifiez la valeur du paramètre ribbonID dans la méthode Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI et retournez le ruban approprié.
La méthode Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI est automatiquement générée par Visual Studio Tools pour Office dans le fichier de code du ruban. Le paramètre ribbonID est une chaîne qui identifie 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;
}