Personnaliser un ruban pour Outlook

Quand vous personnalisez le ruban dans Microsoft Office Outlook, vous devez prendre en compte l'emplacement où votre ruban personnalisé apparaîtra dans l'application. Outlook affiche le ruban dans l'interface utilisateur principale de l'application 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.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets de complément VSTO pour Outlook. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Ajouter 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 , puis en sélectionnant Microsoft.Outlook.Explorer.

Attribuer un ruban à un inspecteur

Pour identifier l'inspecteur que vous souhaitez personnaliser, vous 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 des valeurs.

Vous pouvez ajouter plusieurs rubans à un projet. Si plusieurs rubans partagent un ID de ruban, substituez la méthode CreateRibbonExtensibilityObject de 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 chaque type de ruban, consultez l’article technique Personnaliser le ruban dans Outlook 2007.

Spécifier le type de ruban à l’aide du code XML du ruban

Si vous utilisez l’élément Ribbon (XML), case activée la valeur du paramètre ribbonID dans la GetCustomUI méthode et renvoyez le ruban approprié.

La méthode GetCustomUI 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 Personnaliser le ruban dans Outlook 2007.

L'exemple de code suivant montre comment afficher un ruban personnalisé uniquement dans l' inspecteur Microsoft.Outlook.Mail.Compose. Il s'agit de l'inspecteur qui s'affiche lorsqu'un utilisateur crée un message électronique. Le ruban à afficher est spécifié dans la GetResourceText() méthode, qui est générée dans la classe Ribbon . Pour plus d’informations sur la classe Ribbon, consultez le code XML du ruban.

C#

public string GetCustomUI(string ribbonID)
{
    string ribbonXML = String.Empty;

    if (ribbonID == "Microsoft.Outlook.Mail.Compose")
    {
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
    }

    return ribbonXML;
}

VB

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

Contenu connexe

• Accéder au ruban au moment de l’exécution
• Vue d’ensemble du ruban
• Concepteur de ruban
• Ribbon XML