Microsoft.Office.Tools.Ribbon Namespace

Reference

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The Microsoft.Office.Tools.Ribbon namespace contains components, controls, and supporting collections, classes, and enumerations that enable you to customize the Ribbon in the user interface (UI) of several Microsoft Office applications.

Classes

RibbonBase	Serves as the base class for Microsoft Office Ribbon customizations.
RibbonCollectionBase	Provides access to the IRibbonExtension objects in a Ribbon customization.

Interfaces

IRibbonExtension	Represents an extension of a OfficeRibbon object.
OfficeRibbon	Represents a Microsoft Office Ribbon customization that is created by using the Ribbon Designer in an Office project in Visual Studio.
RibbonBox	Arranges and aligns controls on a custom Ribbon.
RibbonButton	Represents a button on a custom Ribbon.
RibbonButtonGroup	Represents a group of button controls on a Ribbon.
RibbonCheckBox	Represents a check box control on a Ribbon.
RibbonComboBox	Represents a combo box on a custom Ribbon.
RibbonComponent	Contains methods and members that enable communication with Visual Studio, navigation through the control hierarchy in your application, and optimization of the run time layout of controls.
RibbonControl	Provides properties used by controls in a Microsoft Office customization.
RibbonControlEventArgs	Provides data for a variety of events that are raised in a Microsoft Office customization.
RibbonControlId	Encapsulates an identification string that Microsoft Office uses to refer to controls.
RibbonDialogLauncher	Represents a small standardized icon on a group that can be used to open a dialog box.
RibbonDropDown	Represents a list of items that a user can choose from and a list of Ribbon buttons that a user can click.
RibbonDropDownItem	Represents an item in a drop-down list in a Ribbon drop-down.
RibbonEditBox	Represents an edit box on a Ribbon.
RibbonFactory	Provides methods that you can use to create Ribbon controls for a Microsoft Office Ribbon customization.
RibbonGallery	Represents a control that displays a menu of RibbonDropDownItem objects and RibbonButton controls.
RibbonGroup	Represents a group of controls on a Ribbon tab.
RibbonLabel	Represents a label on a RibbonGroup or RibbonBox.
RibbonLoadImageEventArgs	Provides data for the LoadImage event.
RibbonManager	Manages the Ribbon customizations that are created by using the Ribbon Designer in an Office project.
RibbonMenu	Represents a menu on a Ribbon tab or on the Microsoft Office Menu.
RibbonOfficeMenu	Provides access to controls that you add to the Microsoft Office Menu.
RibbonPosition	Represents the location of a Ribbon control on the Microsoft Office Menu relative to a built-in control, the location of a tab relative to a built-in tab, or the location of a group relative to a built-in group.
RibbonPositionStatics	Provides methods that enable you to specify the position of a control, group, or tab in a Ribbon customization.
RibbonReadOnlyCollection	Provides access to the IRibbonExtension objects in a Ribbon customization.
RibbonSeparator	Represents a separator control for a group or menu on the Ribbon.
RibbonSplitButton	A Ribbon control that combines a button or a toggle button and a drop-down menu.
RibbonTab	Contains one or more groups of controls on the Ribbon.
RibbonToggleButton	Represents a toggle button control on a Ribbon.
RibbonUIEventArgs	Provides data for events that are raised in the Ribbon.

Enums

RibbonBoxStyle	Specifies whether controls are aligned vertically or horizontally on a RibbonBox.
RibbonButtonType	Specifies the type of button that a RibbonSplitButton displays.
RibbonControlIdType	Contains values that determine whether a RibbonControlId identifies a Microsoft Office control or a custom control.
RibbonPositionType	Specifies the position of a control on the Microsoft Office Menu, a group of controls on a built-in tab, or a tab among built-in or custom tabs.

Delegates

RibbonControlEventHandler	Represents the method that will handle events of an RibbonControl.
RibbonLoadImageEventHandler	Represents the method that will handle the LoadImage event of an OfficeRibbon.
RibbonUIEventHandler	Represents the method that will handle the Load event of an OfficeRibbon.

Remarks

All of the controls in the Microsoft.Office.Tools.Ribbon namespace can be added to your Office customization by dragging them from the Office Ribbon Controls tab of the ToolBox onto the Ribbon Designer. In addition, the RibbonMenu control enables you to add the following controls at run time:

To add these controls to a RibbonMenu at run time, you must set the Dynamic property of the menu to true at design time.

When you create a control at run time to add to a menu, you can change any properties of the newly created control before you add it to the menu. After you add a control to a menu, some of its properties become read-only. For more information, see Ribbon Object Model Overview.

You can use other properties to control the appearance and behavior of your controls at run time. For example, you can implement run-time changes to the user interface by using the Enabled and Visible properties to enable, disable, show, and hide controls that were added at design time.