Share via

IRibbonUI-Objekt (Office)

  • Artikel

Das Objekt, das von der im customUI-Tag angegebenen onLoad-Prozedur zurückgegeben wird. Das Objekt enthält Methoden, um Steuerelementeigenschaften ungültig zu machen und um die Benutzeroberfläche zu aktualisieren.

Das IRibbonUI-Objekt generiert keine Ereignisse in seiner Interaktion mit dem Benutzer. Stattdessen führen Menübandelemente Callbacks zu Ihrem Code durch, und die Verknüpfung zwischen Menübandelementen und Ihrem Code ist in der XML definiert, die Ihre Menübandergänzungen beschreibt.

Informationen zu den Rückruffunktionen, die für jedes UI-Element verfügbar sind, finden Sie unter Anpassen des Office Fluent-Menübands für Entwickler unter "Wie kann ich die richtigen Signaturen für jede Rückrufprozedur bestimmen?"

HinwBemerkungeneise

Sie können die Menüband-Benutzeroberfläche (UI) mit Callback-Prozeduren in COM-Add-Ins anpassen. Wenn die Hostanwendung gestartet wird, wird die onLoad-Callback-Prozedur aufgerufen. Die Callback-Prozedur gibt dann ein IRibbonUI-Objekt zurück, das auf die Benutzeroberfläche (UI) zeigt. Verwenden Sie dieses Objekt, um die Methoden Invalidate, InvalidateControl und Refresh aufzurufen.

Beispiel

Im folgenden Beispiel löst das Starten der Hostanwendung die onLoad-Ereignisprozedur aus, die dann eine Prozedur aufruft, die ein IRibbonUI-Objekt erstellt, das die Menübandbenutzeroberfläche darstellt. Im nächsten Schritt wird eine Rückrufprozedur definiert, die alle Steuerelemente im Cache ungültig macht und anschließend die Benutzeroberfläche aktualisiert.

<customUI … OnLoad="MyAddInInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls 
End Sub

Siehe auch

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.