IRibbonUI.Invalidate-Methode (Office)
Macht die zwischengespeicherten Werte für alle Steuerelemente der Menüband-Benutzeroberfläche ungültig.
Syntax
Ausdruck. Entkräften
Ausdruck Ein Ausdruck, der ein IRibbonUI-Objekt zurückgibt.
Hinweise
Sie können die Menübandbenutzeroberfläche mithilfe von Rückrufprozeduren in COM-Add-Ins anpassen. Für jeden Rückruf, den das Add-In implementiert, werden die Antworten zwischengespeichert.
Wenn beispielsweise ein Add-In-Writer die getImage-Rückrufprozedur für eine Schaltfläche implementiert, wird die Funktion einmal aufgerufen, das Bild wird geladen. Wenn das Image dann aktualisiert werden muss, wird das zwischengespeicherte Image verwendet, anstatt die Prozedur abzurufen. Dieser Prozess bleibt bestehen, bis das Add-In mit der Invalidate-Methode signalisiert, dass die zwischengespeicherten Werte ungültig sind. Zu diesem Zeitpunkt wird die Rückrufprozedur erneut aufgerufen und die Rückgabeantwort zwischengespeichert. Das Add-In kann dann durch Aufrufen der Refresh-Methode eine sofortige Aktualisierung der Benutzeroberfläche erzwingen.
Beispiel
Im folgenden Beispiel wird beim Starten der Hostanwendung die onLoad-Ereignisprozedur ausgelöst, die dann eine Prozedur aufruft, die ein Objekt erstellt, das die Menübandbenutzeroberfläche darstellt. Im nächsten Schritt wird eine Rückrufprozedur definiert, die alle Steuerelemente auf der Benutzeroberfläche 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.