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
Microsoft Office-Version
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