Référence du développeur Office
IRibbonUI.Invalidate, méthode
Invalide les valeurs mises en cache pour tous les contrôles de l'interface utilisateur du ruban.
Syntaxe
expression.Invalidate
expression Expression qui renvoie un objet IRibbonUI.
Remarques
Vous pouvez personnaliser l'interface utilisateur du ruban en utilisant des procédures de rappel dans les compléments COM. Pour chaque rappel implémenté par le complément, les réponses sont mises en cache. Par exemple, si le générateur d'un complément implémente la procédure de rappel getImage pour un bouton, la fonction est appelée une fois, l'image se charge puis, si l'image a besoin d'être mise à jour, l'image mise en cache est utilisée sans qu'il soit nécessaire de rappeler la procédure. Ce processus reste en place jusqu'à ce que le complément signale que les valeurs mises en cache ne sont pas valides par l'intermédiaire de la méthode Invalidate. À ce moment-là, la procédure de rappel est à nouveau appelée et la réponse renvoyée mise en cache. Le complément peut alors forcer une mise à jour immédiate de l'interface utilisateur en appelant la méthode Refresh.
Exemple
Dans l'exemple suivant, le démarrage de l'application hôte déclenche la procédure événementielle onLoad. Celle-ci appelle alors une procédure qui crée un objet représentant l'interface utilisateur du ruban. Une procédure de rappel invalidant tous les contrôles de l'interface utilisateur et actualisant l'interface utilisateur est ensuite définie.
XML
<customUI … OnLoad=”MyAddinInitialize” …>
Visual Basic pour Applications
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