Edit

SplitButton element (Server Ribbon)

  • Article

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines a control that combines a button and a drop-down menu.

<SplitButton
  Alt="Text"
  CacheMenuVersions="TRUE | FALSE"
  Command="Text"
  CommandMenuOpen="Text"
  CommandMenuClose="Text"
  CommandType="General | OptionSelection | IgnoredByMenu"
  Id="Text"
  Image32by32="Url"
  Image32by32Class="CSS Class Selector"
  Image32by32Left="Negative Integer"
  Image32by32Top="Negative Integer"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  LabelText="Text"
  MenuAlt="Text"
  MenuCommand="Text"
  PopulateDynamically=" TRUE | FALSE "
  PopulateQueryCommand="Text"
  PopulateOnlyOnce=" TRUE | FALSE "
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Class Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipSelectedItemTitle="Text"
  ToolTipShortcutKey="Text"
/>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Alt
Optional. Alternative text that is used for the control.
CacheMenuVersions
Optional. TRUE to store previously constructed versions of a dynamic menu. The default is FALSE.
Command
Optional. The name of the command to execute when the control is selected. If the control is in a CommandUIDefinition element, the value of the Command attribute of the control should be the same as the value of the Command attribute of a corresponding CommandUIHandler element.
CommandMenuOpen
Optional. The name of the command to execute when the menu opens.
CommandMenuClose
Optional. The name of the command to execute when the menu closes.
CommandType
Optional. An enumeration value that specifies the type of command.
General. Not a specific type of command.
OptionSelection. A command that is generated when a user selects one option in an option group.
IgnoredByMenu. A command that is used for controls that should not close the menu when they are selected.
Id
Required. A string that identifies the control.
Image32by32
Optional. A server-relative URL to a file that contains a 32-by-32-pixel image to be used as an icon, such as "/_layouts/1033/images/formatmap32x32.png".
Image32by32Class
Optional. The name of a CSS class selector to be applied to the image.
Image32by32Left
Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image32by32 attribute points to an image file that contains images for many icons.
The value of the Image32by32Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag. For example, setting the Image32by32Left attribute to " -160" and the Image32by32Top attribute to " -448" results in an inline style that is similar to the one in the following HTML markup:
HTML<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" />
Image32by32Top
Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image32by32 attribute points to an image file that contains the images for many icons. The value of the Image32by32Top attribute is used to set the CSS top attribute for the inline style of an HTML img tag.
Image16by16
Optional. A server-relative URL to a file that contains a 16-by-16-pixel image to be used as an icon, such as "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class
Optional. The name of a CSS class selector to be applied to the image.
Image16by16Left
Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. The value of the Image16by16Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag.
Image16by16Top
Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image16by16 attribute points to an image file that contains images for many icons. The value of the Image16by16Top attribute is used to set the CSS top attribute for the inline style of an HTML img tag.
LabelText
Optional. Text to label the control.
MenuAlt
Optional. Alternative text to represent the menu.
MenuCommand
Optional. The name of the command to execute when the menu is selected.
PopulateDynamically
Optional. TRUE to create the menu dynamically. The default is FALSE.
PopulateQueryCommand
Optional. The name of the command to execute when creating a dynamic menu.
PopulateOnlyOnce
Optional. TRUE to populate a dynamic menu only the first time that it is accessed.
Sequence
Optional. An integer that specifies the order of placement among sibling XML nodes.
TemplateAlias
Optional. A string that matches the value of the TemplateAlias attribute for a ControlRef element, an OverflowArea element, or an OverflowSection element in a GroupTemplate element. The TemplateAlias attribute is used to size and position controls in a group when a template is applied to the group.
ToolTipImage32by32
Optional. A server-relative URL to a file that contains a 32-by-32-pixel image to be used in the tooltip, such as "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class
Optional. The name of a CSS selector to be applied to the tooltip image.
ToolTipImage32by32Left
Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. The value of the ToolTipImage32by32Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag when the page is created.
ToolTipImage32by32Top
Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. The value of the ToolTipImage32by32Top attribute is used to set the CSS top attribute for the inline style of an HTML img tag when the page is created.
ToolTipTitle
Optional. The text that appears as the title of the tooltip.
ToolTipDescription
Optional. The text that appears in the body of the tooltip.
ToolTipHelpKeyWord
Optional. The keyword that is used by context-sensitive Help.
ToolTipSelectedItemTitle
Optional. The title of the tooltip that appears for the selected item.
ToolTipShortcutKey
Optional. The text to display for the shortcut key in the tooltip. For example, if the shortcut key for the control is Alt+J, the value for this attribute is "Alt+J". The tooltip displays the text for the shortcut key in parentheses after the tooltip title: "(Alt+J)".

Child elements

Parent elements

Occurrences

  • Minimum: 0
  • Maximum: unbounded