We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

Microsoft.Office.Tools.Ribbon Namespace

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.

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.

Public classRibbonBaseServes as the base class for Microsoft Office Ribbon customizations.
Public classRibbonCollectionBaseProvides access to the IRibbonExtension objects in a Ribbon customization.

Public interfaceIRibbonExtensionRepresents an extension of a OfficeRibbon object.
Public interfaceOfficeRibbonRepresents a Microsoft Office Ribbon customization that is created by using the Ribbon Designer in an Office project in Visual Studio.
Public interfaceRibbonBoxArranges and aligns controls on a custom Ribbon.
Public interfaceRibbonButtonRepresents a button on a custom Ribbon.
Public interfaceRibbonButtonGroupRepresents a group of button controls on a Ribbon.
Public interfaceRibbonCheckBoxRepresents a check box control on a Ribbon.
Public interfaceRibbonComboBoxRepresents a combo box on a custom Ribbon.
Public interfaceRibbonComponentContains 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.
Public interfaceRibbonControlProvides properties used by controls in a Microsoft Office customization.
Public interfaceRibbonControlEventArgsProvides data for a variety of events that are raised in a Microsoft Office customization.
Public interfaceRibbonControlIdEncapsulates an identification string that Microsoft Office uses to refer to controls.
Public interfaceRibbonDialogLauncherRepresents a small standardized icon on a group that can be used to open a dialog box.
Public interfaceRibbonDropDownRepresents a list of items that a user can choose from and a list of Ribbon buttons that a user can click.
Public interfaceRibbonDropDownItemRepresents an item in a drop-down list in a Ribbon drop-down.
Public interfaceRibbonEditBoxRepresents an edit box on a Ribbon.
Public interfaceRibbonFactoryProvides methods that you can use to create Ribbon controls for a Microsoft Office Ribbon customization.
Public interfaceRibbonGalleryRepresents a control that displays a menu of RibbonDropDownItem objects and RibbonButton controls.
Public interfaceRibbonGroupRepresents a group of controls on a Ribbon tab.
Public interfaceRibbonLabelRepresents a label on a RibbonGroup or RibbonBox.
Public interfaceRibbonLoadImageEventArgsProvides data for the LoadImage event.
Public interfaceRibbonManagerManages the Ribbon customizations that are created by using the Ribbon Designer in an Office project.
Public interfaceRibbonMenuRepresents a menu on a Ribbon tab or on the Microsoft Office Menu.
Public interfaceRibbonOfficeMenuProvides access to controls that you add to the Microsoft Office Menu.
Public interfaceRibbonPositionRepresents 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.
Public interfaceRibbonPositionStaticsProvides methods that enable you to specify the position of a control, group, or tab in a Ribbon customization.
Public interfaceRibbonReadOnlyCollectionProvides access to the IRibbonExtension objects in a Ribbon customization.
Public interfaceRibbonSeparatorRepresents a separator control for a group or menu on the Ribbon.
Public interfaceRibbonSplitButtonA Ribbon control that combines a button or a toggle button and a drop-down menu.
Public interfaceRibbonTabContains one or more groups of controls on the Ribbon.
Public interfaceRibbonToggleButtonRepresents a toggle button control on a Ribbon.
Public interfaceRibbonUIEventArgsProvides data for events that are raised in the Ribbon.

Public delegateRibbonControlEventHandlerRepresents the method that will handle events of an RibbonControl.
Public delegateRibbonLoadImageEventHandlerRepresents the method that will handle the LoadImage event of an OfficeRibbon.
Public delegateRibbonUIEventHandlerRepresents the method that will handle the Load event of an OfficeRibbon.

Public enumerationRibbonBoxStyleSpecifies whether controls are aligned vertically or horizontally on a RibbonBox.
Public enumerationRibbonButtonTypeSpecifies the type of button that a RibbonSplitButton displays.
Public enumerationRibbonControlIdTypeContains values that determine whether a RibbonControlId identifies a Microsoft Office control or a custom control.
Public enumerationRibbonPositionTypeSpecifies 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.