IRibbonUI.InvalidateControl-Methode (Office)

Macht den zwischengespeicherten Wert für ein einzelnes Steuerelement der Menüband-Benutzeroberfläche ungültig.

Syntax

Ausdruck verwendet werden. 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üband-Benutzeroberfläche mithilfe von Rückrufprozeduren in COM-Add-Ins anpassen. Für jeden der Rückrufe, die 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, und wenn das Bild aktualisiert werden muss, wird das zwischengespeicherte Bild verwendet, anstatt die Prozedur aufzurufen. 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

• IRibbonUI-Objektmember

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.