Microsoft.Office.Tools.Ribbon Namespace (2007 System)

  • Article

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.

Classes

  Class Description
Public class OfficeRibbon Serves as the base class for Microsoft Office Ribbon customizations.
Public class RibbonBox Arranges and aligns controls on a custom Ribbon.
Public class RibbonButton Represents a button on a custom Ribbon.
Public class RibbonButtonCollection Represents a collection of RibbonButton objects.
Public class RibbonButtonGroup Represents a group of button controls on a Ribbon.
Public class RibbonCheckBox Represents a check box control on a Ribbon.
Public class RibbonComboBox Represents a combo box on a custom Ribbon.
Public class RibbonComponent Base class for controls on a custom Ribbon.
Public class RibbonComponentCollection<T> Represents a collection of Ribbon components.
Public class RibbonControl The base class for controls in a Microsoft Office customization.
Public class RibbonControlEventArgs Provides data for a variety of events that are raised in a Microsoft Office customization.
Public class RibbonControlId Encapsulates an identification string that Microsoft Office uses to refer to controls.
Public class RibbonDialogLauncher Represents a small standardized icon on a group that can be used to open a dialog box.
Public class RibbonDropDown Represents a list of items that a user can choose from and a list of Ribbon buttons that a user can click.
Public class RibbonDropDownItem Represents an item in a drop-down list in a RibbonDropDownItemCollection.
Public class RibbonDropDownItemCollection Represents a collection of RibbonDropDownItem objects.
Public class RibbonEditBox Represents an edit box on a Ribbon.
Public class RibbonEventAttribute Infrastructure.
Public class RibbonGallery Represents a control that displays a menu of RibbonDropDownItem objects and RibbonButton controls.
Public class RibbonGroup Represents a group of controls on a Ribbon tab.
Public class RibbonLabel Represents a label on a RibbonGroup or RibbonBox.
Public class RibbonLoadImageEventArgs Provides data for the LoadImage event.
Public class RibbonManager Manages the custom Ribbons in a Visual Studio Tools for Office project.
Public class RibbonMenu Represents a menu on a Ribbon tab or on the Microsoft Office Menu.
Public class RibbonOfficeMenu Provides access to controls that you add to the Microsoft Office Menu.
Public class 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.
Public class RibbonReadOnlyCollection Provides access to the OfficeRibbon instances in a Ribbon customization.
Public class RibbonSeparator Represents a separator control for a group or menu on the Ribbon. This class cannot be inherited.
Public class RibbonSplitButton A Ribbon control that combines a button or a toggle button and a drop-down menu. This class cannot be inherited.
Public class RibbonTab Contains one or more groups of controls on the Ribbon. This class cannot be inherited.
Public class RibbonToggleButton Represents a toggle button control on a Ribbon. This class cannot be inherited.
Public class RibbonUIEventArgs Provides data for events that are raised in the Ribbon. This class cannot be inherited.

Enumerations

  Enumeration Description
Public enumeration RibbonBoxStyle Specifies whether controls are aligned vertically or horizontally on a RibbonBox.
Public enumeration RibbonButtonType Specifies the type of button that a RibbonSplitButton displays.
Public enumeration RibbonControlIdType Contains values that determine whether a RibbonControlId identifies a Microsoft Office control or a custom control.
Public enumeration 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.

See Also

Reference

Other Resources

Ribbon Object Model Overview

Ribbon Overview