IRibbonUI.InvalidateControl(String) Methode

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

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

public:
 void InvalidateControl(System::String ^ ControlID);

public void InvalidateControl (string ControlID);

abstract member InvalidateControl : string -> unit

Public Sub InvalidateControl (ControlID As String)

Parameter

ControlID

String

Gibt die ID des Steuerelements an, das ungültig gemacht wird.

Beispiele

Im folgenden Beispiel löst die hostanwendung starten die OnLoad -Ereignisprozedur, die eine Prozedur dann die erstellt ein Objekt ruft, das der Menüband-Benutzeroberflä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.

Es folgt das XML-Markup für Office zum Laden des benutzerdefinierten Menübands:

<customUI … onLoad=”MyAddInInitialize” …>

Es folgt die Rückrufmethode für das onLoad-Ereignis :

Dim MyRibbon As IRibbonUI
Sub MyAddInInitialize(Ribbon As IRibbonUI)
    Set MyRibbon = Ribbon
End Sub

Sub myFunction()
    ‘ Invalidates the cache of a single control 
    MyRibbon.InvalidateControl(“control5”)            
End Sub

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 aktiviert, 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.