Freigeben über


Anpassen eines Menübands für Outlook

Wenn Sie das Menüband in Microsoft Office Outlook anpassen, müssen Sie überlegen, wo Ihr benutzerdefiniertes Menüband in der Anwendung angezeigt wird. Outlook zeigt das Menüband auf der Benutzeroberfläche der Hauptanwendung und in Fenstern an, die geöffnet werden, wenn Benutzer bestimmte Aufgaben ausführen, z. B. das Erstellen von E-Mail-Nachrichten. Diese Anwendungsfenster werden als "Inspektoren" bezeichnet.

Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für Outlook. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

Hinzufügen eines benutzerdefinierten Menübands zur Hauptanwendungs-UI

Die Hauptanwendungs-UI in Outlook wird als Explorer bezeichnet. Wenn Sie das Menübandelement (Visual Designer) verwenden, können Sie dem Explorer ein Menüband hinzufügen, indem Sie im Eigenschaftenfenster auf die RibbonType-Eigenschaft des Menübands klicken und dann Microsoft.Outlook.Explorer auswählen.

Zuweisen eines Menübands zu einem Inspektor

Sie identifizieren den Inspektor, den Sie anpassen möchten, indem Sie den Menübandtyp angeben, der der Nachrichtenklasse für den Inspektor entspricht.

Wenn Sie das Menübandelement (Visual Designer) verwenden, klicken Sie im Eigenschaftenfenster auf die RibbonType-Eigenschaft des Menübands, und wählen Sie dann eine oder mehrere Menüband-IDs aus der Liste der Werte aus.

Sie können einem Projekt mehrere Menübänder hinzufügen. Wenn mehrere Menübänder eine Menüband-ID gemeinsam verwenden, überschreiben Sie die CreateRibbonExtensibilityObject Methode in der ThisAddin Klasse Ihres Projekts, um anzugeben, welches Menüband zur Laufzeit angezeigt werden soll. Weitere Informationen finden Sie in der Menübandübersicht. Weitere Informationen zu jedem Menübandtyp finden Sie im technischen Artikel "Anpassen des Menübands in Outlook 2007".

Angeben des Menübandtyps mithilfe von Menüband-XML

Wenn Sie das Menübandelement (XML) verwenden, überprüfen Sie den Wert des RibbonID-Parameters in der GetCustomUI Methode, und geben Sie das entsprechende Menüband zurück.

Die GetCustomUI Methode wird automatisch von Visual Studio in der Menübandcodedatei generiert. Der RibbonID-Parameter ist eine Zeichenfolge, die den Explorer oder einen bestimmten Inspektortyp identifiziert. Eine vollständige Liste der möglichen Werte des RibbonID-Parameters finden Sie im technischen Artikel Zum Anpassen des Menübands in Outlook 2007.

Im folgenden Codebeispiel wird veranschaulicht, wie ein benutzerdefiniertes Menüband nur im Microsoft.Outlook.Mail.Compose Inspektor angezeigt wird. Dies ist der Inspektor, der geöffnet wird, wenn ein Benutzer eine neue E-Mail-Nachricht erstellt. Das anzuzeigende Menüband wird in der GetResourceText() Methode angegeben, die in der Ribbon-Klasse generiert wird. Weitere Informationen zur Ribbon-Klasse finden Sie unter Ribbon XML.

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

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

    return ribbonXML;
}