Freigeben über


Anpassen eines Menübands für Outlook

Beim Anpassen des Menübands in Microsoft Office Outlook müssen Sie berücksichtigen, wo das benutzerdefinierte Menüband in der Anwendung angezeigt wird. Outlook zeigt das Menüband in der Benutzeroberfläche der Hauptanwendung und in Fenstern an, die geöffnet werden, wenn Benutzer bestimmte Aufgaben ausführen, z. B. eine E-Mail erstellen. 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 features available by Office-App lication and project type.

Hinzufügen eines benutzerdefinierten Menübands zur benutzerdefinierten Benutzeroberfläche der Standard Anwendung

Die Benutzeroberfläche der Hauptanwendung in Outlook ist der Explorer. 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 anzupassenden Inspektor durch Angabe des Menübandtyps, der der Nachrichtenklasse des Inspektors 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 sich mehrere Menübänder eine Menüband-ID teilen, überschreiben Sie die CreateRibbonExtensibilityObject-Methode in der ThisAddin-Klasse des Projekts, um anzugeben, welches Menüband zur Laufzeit angezeigt werden soll. Weitere Informationen finden Sie in der Übersicht über das Menüband. 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üband-Codedatei 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 erstellt. Das anzuzeigende Menüband wird in der GetResourceText() Methode angegeben, die in der Ribbon-Klasse generiert wird. Weitere Informationen zur Menübandklasse finden Sie unter Menüband-XML.

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

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

    return ribbonXML;
}