IRibbonUI.Invalidate Methode

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Macht die zwischengespeicherten Werte für alle Steuerelemente der Menüband-Benutzeroberfläche ungültig.

public:
 void Invalidate();

public void Invalidate ();

abstract member Invalidate : unit -> unit

Public Sub Invalidate ()

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 alle Steuerelemente auf der Benutzeroberfläche ungültig macht 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 caches of all of this add-in’s controls 
    MyRibbon.Invalidate()            
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 an Ort und Stelle, 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 eine sofortige Aktualisierung der Benutzeroberfläche erzwingen, indem die Refresh-Methode aufgerufen wird.