RibbonComboBox Class (2007 System)

Represents a combo box on a custom Ribbon.

Namespace:  Microsoft.Office.Tools.Ribbon
Assembly:  Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
<ToolboxBitmapAttribute(GetType(RibbonComboBox), "RibbonComboBox.bmp")> _
Public NotInheritable Class RibbonComboBox _
    Inherits RibbonControl
'Usage
Dim instance As RibbonComboBox
[ToolboxBitmapAttribute(typeof(RibbonComboBox), "RibbonComboBox.bmp")]
public sealed class RibbonComboBox : RibbonControl
[ToolboxBitmapAttribute(typeof(RibbonComboBox), L"RibbonComboBox.bmp")]
public ref class RibbonComboBox sealed : public RibbonControl
public final class RibbonComboBox extends RibbonControl

Remarks

A combo box presents a user with a text entry field and a list of choices in a drop-down menu.

You can add RibbonDropDownItem objects to a RibbonComboBox at design time or at run time.

To add RibbonDropDownItem objects at design time

  1. Click the Items property in the Properties window.

  2. Click the ellipsis (...).

  3. Use the DropDown Collection Editor to add, order, and edit new items.

    These items are added to this RibbonComboBox object's Items collection.

The following steps explain how to add a RibbonDropDownItem at run time.

To add a RibbonDropDownItem object at run time

  1. Create a new RibbonDropDownItem by using the RibbonDropDownItem.

  2. Add the RibbonDropDownItem you created to the Items collection for this RibbonDropDownItem object.

Some members of this type can be set only before the Ribbon is loaded into the Office application. For information about setting these properties, see Ribbon Object Model Overview.

Inheritance Hierarchy

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonComboBox

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

RibbonComboBox Members

Microsoft.Office.Tools.Ribbon Namespace

Other Resources

Ribbon Overview

Ribbon Designer

Ribbon Object Model Overview

How to: Get Started Customizing the Ribbon