IRibbonUI Interface

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

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.

public interface class IRibbonUI

[System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")]
public interface IRibbonUI

[<System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")>]
type IRibbonUI = interface

Public Interface IRibbonUI

Attributs

GuidAttribute

Exemples

Dans l’exemple suivant, le démarrage de l’application hôte déclenche la procédure événementielle onLoad. Celle-ci appelle alors 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.

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 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 alors un objet IRibbonUI pointant vers l’interface utilisateur. Vous pouvez utiliser cet objet pour appeler les méthodes Invalidate, InvalidateControl et Refresh.

Méthodes

ActivateTab(String)	Active l’onglet personnalisé spécifié.
ActivateTabMso(String)	Active l’onglet intégré spécifié.
ActivateTabQ(String, String)	Active l’onglet personnalisé spécifié dans l’interface utilisateur du ruban Microsoft Office Fluent. Utilise le nom complet de l’onglet qui inclut l’identificateur et l’espace de noms de l’onglet.
Invalidate()	Invalide les valeurs mises en cache pour tous les contrôles de l’interface utilisateur du Ruban.
InvalidateControl(String)	Invalide la valeur mise en cache pour un seul contrôle de l’interface utilisateur du Ruban.
InvalidateControlMso(String)	Utilisée pour invalider un contrôle intégré.