IRibbonUI.InvalidateControl(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.