IRibbonUI.InvalidateControl-Methode (Office)
Macht den zwischengespeicherten Wert für ein einzelnes Steuerelement der Menüband-Benutzeroberfläche ungültig.
Syntax
Ausdruck. InvalidateControl (bstrControlID)
Ausdruck Ein Ausdruck, der ein IRibbonUI-Objekt zurückgibt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| bstrControlID | Erforderlich | String | Gibt die ID des Steuerelements an, das ungültig gemacht wird. |
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 für das Steuerelement bestehen, bis das Add-In mit der InvalidateControl-Methode signalisiert, dass die zwischengespeicherten Werte ungültig sind. Zu diesem Zeitpunkt wird die Rückrufprozedur erneut aufgerufen und die Rückgabeantwort zwischengespeichert.
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 ein Steuerelement auf der Benutzeroberfläche erklärt 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.InvalidateControl("control1") ' Invalidates the cache of a single control
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.