IRibbonUI.InvalidateControl(String) Méthode

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Invalide la valeur mise en cache pour un seul contrôle de l’interface utilisateur du Ruban.

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

public void InvalidateControl (string ControlID);

abstract member InvalidateControl : string -> unit

Public Sub InvalidateControl (ControlID As String)

Paramètres

ControlID

String

Spécifie l'identificateur du contrôle qui sera invalidé

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 un contrôle sur 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 cache of a single control 
    MyRibbon.InvalidateControl(“control5”)            
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 en place pour le contrôle jusqu’à ce que le complément signale que les valeurs mises en cache ne sont pas valides à l’aide de la méthode InvalidateControl , à ce moment-là, la procédure de rappel est à nouveau appelée et la réponse de retour est mise en cache.