DropDownButton element

Represents a standard Drop-Down Button control.

Usage

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

Attributes

AttributeTypeRequiredDescription

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

ElementDescription

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 emptyNo

See also

Drop-Down Button control
SetModes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft