SplitButtonGallery element (Windows)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

SplitButtonGallery element

Applies to: desktop apps only

Represents a Split Button Gallery control with a gallery-based, drop-down menu.

Usage

<SplitButtonGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</SplitButtonGallery>

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.
HasLargeItems	Boolean	No	Determines whether the large or small image resource of the Command is displayed in the gallery control. Note Applies only to galleries where the value of the Type attribute is equal to `Command`. Restricted to one of the following values (0 and 1 are not valid): (true) Default. (false)
ItemHeight	xs:integer	No	(xs:integer) The default is -1.
ItemWidth	xs:integer	No	(xs:integer) The default is -1.
TextPosition	TextPositionType	No	Restricted to one of the following values: (Bottom) (Hide) (Left) (Overlap) (Right) (Top)
Type	xs:string	No	Restricted to one of the following values: (Items) (Commands)

Child elements

Element	Description
Button	May occur one or more times
CheckBox	May occur one or more times
SplitButton	May occur one or more times
SplitButtonGallery.MenuGroups	Must occur exactly once
SplitButtonGallery.MenuLayout	May occur at most once
ToggleButton	May occur one or more times

Parent elements

Element
ControlGroup
Group
MenuGroup
SplitButton

Remarks

Optional.

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

SplitButtonGallery supports application modes.

If MenuGroup is the parent element, then SplitButtonGallery must have no child elements.

UI_PKEY_BooleanValue is used by an application to query the toggle-state for the button control of a SplitButtonGallery.

The following screen shot illustrates the Ribbon Split Button Gallery control in Microsoft Paint for Windows 7.

Screen shot of a Split Button Gallery control in Microsoft Paint for Windows 7.

Examples

The following example demonstrates the basic markup for the Split Button Gallery.

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


<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

This section of code shows the SplitButtonGallery control declarations.


<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

Element information

Minimum supported system	Windows 7
Can be empty	No