IRibbonUI-Objekt (Office)
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?"
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.
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
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.