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 in seiner Interaktion mit dem Benutzer keine Ereignisse. 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 Benutzeroberflächenelement verfügbar sind, finden Sie unter Anpassen des Office Fluent-Menübands für Entwickler nach "Wie kann ich die richtigen Signaturen für jede Rückrufprozedur ermitteln?".

Hinweise

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 wird beim Starten der Hostanwendung die onLoad-Ereignisprozedur ausgelöst, die dann eine Prozedur aufruft, die ein IRibbonUI-Objekt erstellt, das die Menüband-Benutzeroberflä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.

  • Last updated on