Freigeben über


Anpassen einer Multifunktionsleiste in Outlook

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office.

Projekttyp

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • Outlook 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Wenn Sie die Multifunktionsleiste in Microsoft Office Outlook 2007 anpassen, müssen Sie berücksichtigen, an welcher Stelle der Anwendung die benutzerdefinierte Multifunktionsleiste angezeigt wird. In Outlook wird die Multifunktionsleiste nicht auf der Benutzeroberfläche der Hauptanwendung angezeigt. Stattdessen wird die Multifunktionsleiste in Outlook in Fenstern angezeigt, die geöffnet werden, wenn Benutzer bestimmte Aufgaben, z. B. das Erstellen einer E-Mail-Nachricht, ausführen. Diese Anwendungsfenster werden als Inspektoren bezeichnet.

Zuordnen einer Multifunktionsleiste zu einem Inspektor

Der anzupassende Inspektor wird durch Angeben des Multifunktionsleistentyps identifiziert, der der Nachrichtenklasse für den Inspektor entspricht. Die Schritte für das Angeben des Multifunktionsleistentyps hängen davon ab, ob Sie den Multifunktionsleisten-Designer oder Multifunktionsleisten-XML verwenden.

Verwenden des Multifunktionsleisten-Designers

Wird das Element Multifunktionsleiste (Visual Designer) verwendet, klicken Sie auf die RibbonType-Eigenschaft der Multifunktionsleiste im Fenster Eigenschaften, und wählen Sie anschließend in der Liste der Werte mindestens eine Multifunktionsleisten-ID aus.

Einem Projekt kann mehr als eine Multifunktionsleiste hinzugefügt werden. Wird von mehreren Multifunktionsleisten gemeinsam eine Multifunktionsleisten-ID genutzt, überschreiben Sie die CreateRibbonExtensibilityObject-Methode in der ThisAddin-Klasse des Projekts, um die während der Laufzeit anzuzeigende Multifunktionsleiste anzugeben.

Weitere Informationen hierzu finden Sie unter Übersicht über die Multifunktionsleiste.

Weitere Informationen über die einzelnen Multifunktionsleistentypen finden Sie im technischen Artikel Anpassen der Multifunktionsleiste in Outlook 2007.

Verwenden von Multifunktionsleisten-XML

Wird das Element Multifunktionsleiste (XML) verwendet, überprüfen Sie den Wert des ribbonID-Parameters in der Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI-Methode, und geben Sie die entsprechende Multifunktionsleiste zurück.

Die Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI-Methode wird in der Multifunktionsleisten-Codedatei automatisch von Visual Studio Tools for Office generiert. Der ribbonID-Parameter ist eine Zeichenfolge, die einen bestimmten Typ von Inspektor angibt. Eine vollständige Liste der möglichen Werte des ribbonID-Parameters finden Sie im technischen Artikel Anpassen der Multifunktionsleiste in Outlook 2007.

Im folgenden Codebeispiel wird veranschaulicht, wie nur im Microsoft.Outlook.Mail.Compose-Inspektor eine benutzerdefinierte Multifunktionsleiste angezeigt wird. Dies ist der Inspektor, der geöffnet wird, wenn ein Benutzer eine neue E-Mail-Nachricht erstellt. Die anzuzeigende Multifunktionsleiste wird in der GetResourceText()-Methode angegeben, die in der Multifunktionsleistenklasse generiert wird. Weitere Informationen zur Multifunktionsleistenklasse finden Sie unter Multifunktionsleisten-XML.

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;
}

Siehe auch

Konzepte

Zugreifen auf die Multifunktionsleiste zur Laufzeit

Übersicht über die Multifunktionsleiste

Multifunktionsleisten-Designer

Multifunktionsleisten-XML