Objet IRibbonUI (Office)
Objet renvoyé par la procédure onLoad spécifiée dans la balise customUI. L’objet contient des méthodes qui visent à invalider les propriétés des contrôles et à actualiser l’interface utilisateur.
L’objet IRibbonUI ne génère pas d’événements dans son interaction avec l’utilisateur. Au lieu de cela, les éléments du ruban effectuent des rappels à votre code, et la liaison entre les éléments du ruban et votre code est définie dans le fichier XML qui décrit vos ajouts de ruban.
Pour plus d’informations sur les fonctions de rappel disponibles pour chaque élément d’interface utilisateur, recherchez « Comment puis-je déterminer les signatures correctes pour chaque procédure de rappel ? » dans Personnalisation du ruban Office Fluent 2007 pour les développeurs.
Vous pouvez personnaliser l’interface utilisateur du ruban à l’aide des procédures de rappel dans les compléments COM. Lorsque l’application hôte démarre, la procédure de rappel onLoad est appelée. La procédure de rappel renvoie ensuite un objet IRibbonUI qui pointe vers l’interface utilisateur. Utilisez cet objet pour appeler les méthodes Invalidate, InvalidateControl et Refresh .
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 IRibbonUI représentant l’interface utilisateur du ruban. Une procédure de rappel invalidant tous les contrôles mis en cache et actualisant l’interface utilisateur est ensuite définie.
<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
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.