DropDownButton element

Article
08/20/2021

Represents a standard Drop-Down Button control.

Usage

<DropDownButton
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</DropDownButton>

Attributes

Attribute	Type	Required	Description
ApplicationModes	xs:string	No	Valid only if MenuGroup is the parent element. (xs:string) A string that contains a comma-separated list of integers between 0 and 31. White space is valid and ignored. Maximum length: 250 characters.
CommandName	xs:positiveInteger or xs:string	No	Associates the element with a Command. (xs:positiveInteger or xs:string) A string, an integer value between 2 and 59999, inclusive, or a hexadecimal value between 0x2 and 0xea5f, inclusive. The value must be unique within the Ribbon XML document. Maximum length: 100 characters.

Child elements

Element	Description
Button	May occur one or more times
CheckBox	May occur one or more times
ComboBox	May occur one or more times
DropDownButton	May occur one or more times
DropDownColorPicker	May occur one or more times
DropDownGallery	May occur one or more times
MenuGroup	Must occur at least once
SplitButton	May occur one or more times
SplitButtonGallery	May occur one or more times
ToggleButton	May occur one or more times

Parent elements

Element
ControlGroup
DropDownButton
DropDownGallery
Group
MenuGroup
SplitButton
SplitButtonGallery

Remarks

Optional or required, depending on the parent element.

May occur one or more times for each ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton, or SplitButtonGallery element.

DropDownButton supports application modes when it is hosted in the left column of the Application Menu.

DropDownGallery and SplitButtonGallery are not valid child elements of DropDownButton when DropDownButton is a descendant of ApplicationMenu.

Examples

The following example demonstrates the basic markup for the DropDownButton.

This section of code shows the DropDownButton Command declarations, with an associated Group that functions as the parent container for the DropDownButton element.

<!-- DropDownButton -->
<Command Name="cmdDropDownButtonGroup"
         Symbol="cmdDropDownButtonGroup"
         Comment="DropDownButton Group"
         LabelTitle="DropDownButton"/>
<Command Name="cmdDropDownButton"
         Symbol="cmdDropDownButton"
         Comment="DropDownButton"
         LabelTitle="DropDownButton"/>
<Command Name="cmdDDBButton1"
         Symbol="cmdDDBButton1"
         Comment="DDBButton1"
         LabelTitle="DDB Button"/>
<Command Name="cmdDDBColorPicker"
         Symbol="cmdDDBColorPicker"
         Comment="DDBColorPicker"
         LabelTitle="DDB ColorPicker"/>

This section of code shows the DropDownButton control declarations.

<Group CommandName="cmdDropDownButtonGroup">
  <DropDownButton CommandName="cmdDropDownButton">
    <MenuGroup>
      <Button CommandName="cmdDDBButton1"/>
      <DropDownColorPicker CommandName="cmdDDBColorPicker"/>
    </MenuGroup>
  </DropDownButton>
</Group>

Element information

Minimum supported system: Windows 7
Can be empty: No