IRibbonUI.Invalidate Méthode

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

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

public:
 void Invalidate();

public void Invalidate ();

abstract member Invalidate : unit -> unit

Public Sub Invalidate ()

Exemples

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.

Voici le balisage XML permettant à Office de charger le ruban personnalisé :

<customUI … onLoad=”MyAddInInitialize” …>

Voici la méthode de rappel pour l’événement onLoad :

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

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 sur 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 .