Übersicht über das IRibbonControl-Objekt

  • Artikel

Das IRibbonControl-Objekt wird in den meisten Rückrufen übergeben, die für Steuerelemente im Menüband oder in der Microsoft Office Backstage-Ansicht verfügbar sind, sowie in den anpassbaren Menüelementen in Microsoft Outlook. Das -Objekt ist besonders nützlich für Outlook-Entwickler, da es eine IRibbonControl.Context-Eigenschaft bereitstellt, die das zugehörige Outlook-Objekt zurückgibt, auf das die Anpassung angewendet wird und angezeigt werden soll.

Die Context-Eigenschaft gibt beispielsweise das Explorer-Objekt zurück, wenn Sie das Menüband in einem Explorer anpassen, und das Store-Objekt , wenn Sie das Kontextmenü für einen Store-Ordner anpassen.

Durch IRibbonControl werden die folgenden Eigenschaften zur Verfügung gestellt.

Eigenschaft Typ Beschreibung
Kontext Objekt Gibt ein Objekt zurück, das das Fenster darstellt, in dem das benutzerdefinierte Menüband angezeigt werden soll, oder das zugehörige Objekt, auf das die Menüanpassung angewendet und das angezeigt werden soll. Schreibgeschützt.
ID String Gibt eine Zeichenfolge zurück, die das Attribut ID für das Steuerelement oder das benutzerdefinierte Menüelement darstellt. Schreibgeschützt.
Tag String Gibt eine Zeichenfolge zurück, die das Attribut Tag für das Steuerelement oder das benutzerdefinierte Menüelement darstellt. Schreibgeschützt.

Versuchen Sie beim Schreiben von verwaltetem Code, das durch IRibbonControl.Context dargestellte Objekt in das entsprechende Outlook-Objekt umzuverwanden. Wenn Sie z. B. ein Menüband in einem Inspektor anpassen, wandeln Sie das Inspector-Objekt um. Wenn die Umwandlung erfolgreich ist, können Sie das von IRibbonControl.Context zurückgegebene Inspector-Objekt mit anderen geöffneten Inspektorfenstern vergleichen. Wenn Sie das zugrunde liegende Element ermitteln möchten, das in einem Inspektorfenster angezeigt wird, untersuchen Sie Inspector.CurrentItem. Da CurrentItem ein Object-Typ ist, muss Ihr Code das Objekt in einen entsprechenden Elementtyp wie etwa MailItem oder ContactItem umwandeln.

Siehe auch

Erweiterbarkeit der Office Fluent-Benutzeroberfläche für OutlookImplementierung der IRibbonExtensibility-Schnittstelle

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.