IRibbonControl Interface

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Représente l’objet passé dans la procédure de rappel de chaque contrôle d’interface utilisateur du ruban.

public interface class IRibbonControl

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

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

Public Interface IRibbonControl

Attributs

GuidAttribute

Exemples

L’exemple suivant, écrit en C#, montre deux procédures appelées à partir de la procédure événementielle onAction d’un contrôle Button et d’un contrôle ToggleButton. Dans la première procédure, l'objet IRibbonControl, qui représente le contrôle, est transmis à la procédure et une boîte de message s'affiche pour indiquer que le bouton désigné par son identificateur a été activé. La deuxième procédure est similaire à la première si ce n'est quelle contient en plus un paramètre de type Boolean qui indique que le bouton a été activé.

<span class="label">public void ButtonOnAction(IRibbonControl control) 
   MessageBox.Show("Button clicked: " + control.Id); 
} 

public void ToggleButtonOnAction(IRibbonControl control, bool pressed) 
{ 


...if (pressed) 

      MessageBox.Show("ToggleButton was switched on."); 


   else 
      MessageBox.Show("ToggleButton was switched off."); 

}</span>

Remarques

L’objet IRibbonControl contient le nom (ID) du contrôle et l’objet Window actif pour le contrôle d’interface utilisateur du ruban.

Propriétés

Context	Représente la fenêtre active contenant l'interface utilisateur du ruban qui déclenche une procédure de rappel. En lecture seule.
Id	Renvoie l’ID du contrôle spécifié dans le fichier de personnalisation de balisage XML du Ruban. En lecture seule.
Tag	Cette propriété permet de stocker des chaînes arbitraires et de les extraire au moment de l'exécution. Lecture seule