Partager via


Méthode IRibbonUI.Invalidate (Office)

Invalide les valeurs mises en cache pour tous les contrôles de l'interface utilisateur du ruban.

Syntaxe

expression. Invalider

Expression Expression qui renvoie un objet IRibbonUI .

Remarques

Vous pouvez personnaliser l’interface utilisateur du ruban à l’aide de procédures de rappel dans les compléments COM. Pour chacun des rappels implémentés par le complément, les réponses sont mises en cache.

Par exemple, si un enregistreur de 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 doit être mise à jour, l’image mise en cache est utilisée au lieu 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 à l’aide de la méthode Invalidate , à partir de laquelle la procédure de rappel est à nouveau appelée et la réponse de retour est mise en cache. Le complément peut ensuite 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 qui appelle ensuite une procédure qui crée un objet représentant l’interface utilisateur du ruban. Ensuite, une procédure de rappel est définie qui invalide tous les contrôles de l’interface utilisateur, puis actualise l’interface utilisateur.

<customUI … OnLoad="MyAddinInitialize" …>
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

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.