Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

AttributeDescriptionVersion IntroducedPro Version Introduced
BeginGroupDetermines if this control begins a new group.1.03.2
CommandThe command associated with this button1.03.2
KeyThe unique identifier of the button. (Required)1.03.2
ForceSmallForces the button to use the small button layout.n/a4.0.1

BeginGroup

The BeginGroup attribute can be set to "True" or "False". When set to "True", it informs the ribbon that this control should not be grouped with the control before it and should be the first control in a new group. This attribute only works if the control is in a group whose GroupControls attribute is "True".

...

The Key attribute defines a unique identifier for the split button. The identifier must be unique among controls but can share the same identifier as other elements such as commands or tabs.

ForceSmall

The ForceSmall attribute can be used to ensure that a button will always use the small button layout even if there is room for a large button layout. Useful when you want to demphasize a button or have a little more control over layout. Set this to "true" to activate. (Only available in 4.0.1 or later.)

Remarks

The SplitButton element defines a split button control. A split button is a button with a drop down arrow. The user can either click on the button portion, which will execute the associated command or the drop down to get a popup with more controls. In order to set the button's caption, icon, and other attributes, you must associate it with a command. You can do this using either the Command attribute as explained above or by including a child <Command> element.

...