IRibbonControl Schnittstelle

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Stellt das -Objekt dar, das an die Rückrufprozedur jedes Menüband-Benutzeroberflächen-Steuerelements übergeben wird.

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

Attribute

GuidAttribute

Beispiele

Das folgende In C# geschriebene Beispiel zeigt zwei Prozeduren, die aus der onAction-Ereignisprozedur eines Button-Steuerelements und eines ToggleButton-Steuerelements aufgerufen werden. In der ersten Prozedur wird das IRibbonControl-Objekt , das das Steuerelement darstellt, an die Prozedur übergeben, und ein Meldungsfeld wird angezeigt, das angibt, dass die Schaltfläche zusammen mit der ID der Schaltfläche gedrückt wurde. Die zweite Prozedur ähnelt der ersten mit dem Hinzufügen eines booleschen Parameters, der angibt, dass die Schaltfläche gedrückt wurde.

<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>

Hinweise

Das IRibbonControl-Objekt enthält den Namen (ID) des Steuerelements und das aktuelle Window-Objekt für das Menüband-UI-Steuerelement.

Eigenschaften

Context	Stellt das aktive Fenster dar, das die Menüband-Benutzeroberfläche enthält, die eine Rückrufprozedur auslöst. Schreibgeschützt.
Id	Ruft die ID des Steuerelements ab, das in der Menüband-XML-Markup-Anpassungsdatei angegeben ist. Schreibgeschützt.
Tag	Wird verwendet, um beliebige Zeichenfolgen zu speichern und zur Laufzeit abzurufen. Schreibgeschützt