RibbonDropDown Interface

Definition

public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

Attributes

GuidAttribute

Implements

RibbonComponent RibbonControl IComponent IDisposable

Remarks

A RibbonDropDown can contain RibbonDropDownItem objects and RibbonButton controls.

You can create a RibbonDropDown at run time by using the CreateRibbonDropDown method of the RibbonFactory object.

There are two ways to access the RibbonFactory object:

• By using the Factory property of the Ribbon class. Use this approach from code in your Ribbon class.

• By using the Globals.Factory.GetRibbonFactory method. Use this approach from code outside your Ribbon class.

You cannot add buttons to the Buttons collection at run time after the Ribbon has been loaded into Office.

The procedures below explain how to add RibbonDropDownItem objects and RibbonButton controls to a RibbonDropDown.

To add RibbonDropDownItem objects at design time

1. Click the Items property in the Properties window.

2. Click the ellipsis (...).

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

You can add RibbonButton controls to a RibbonDropDown at design time.

To add RibbonButton controls at design time

1. Click the Buttons property in the Properties window.

2. Click the ellipsis (...).

3. In the Button Collection Editor, add, order, and edit new button controls.

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.

Usage

This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 or later. In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.

Properties

Methods

Events

Applies to