splitButton
In the object model this is RibbonSplitButton.
combines a button and a menu
you can either click the button or click on the menu
This is similar to the menu control in that it can include other controls
A SplitButton can be clicked directly and pushed as a button or its dropdown list can be displayed
It can also be configured to act list a togglebutton and have a toggled checked or unchecked state
Unlike the menu control the items cannot be changed dynamically at runtime
The buttons element cannot include a "size" attribute when they are inside a splitbutton.
<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
<ribbon startFromScratch="true">
<tabs>
<tab id="CustomTab" label="My Tab">
<group id="Group1" label="Group 1">
<splitButton id="MySplitButton1"
size="large">
<button id="Button1"
label="Normal Button with Menu"
imageMso="LeaveReader" />
<menu id="Menu1"
itemSize="normal" >
<button id="Button2" label="First" />
<button id="Button3" label="Second" />
<button id="Button4" label="Third" />
</menu>
</splitButton>
<splitButton id="MySplitButton2"
size="large">
<button id="Button5"
label="Large Button with Menu"
imageMso="LeaveReader" />
<menu id="Menu2"
itemSize="normal" >
<button id="Button6" label="First" />
<button id="Button7" label="Second" />
<button id="Button8" label="Third" />
</menu>
</splitButton>
</group>
</tab>
</tabs>
</ribbon>
</customUI>
Attributes (properties)
buttonenabled | (ButtonEnabled) whether the button part is enabled |
buttontype | (ButtonType) whether the button is a regular button or a toggle button |
checked | (Checked) only used when togglebutton |
description | (Description) |
enabled | "true" | "false" |
id | |
idMso | (OfficeImageID) |
idQ | |
insertAfterMso | |
insertAfterQ | |
insertBeforeMso | |
insertBeforeQ | |
keytip | |
label | |
position | (Position) |
screentip | |
showLabel | (ShowLabel) "true" | "false" |
size | (ItemSize) |
supertip | (SuperTip) |
tag | |
title | (Title) only used when added to OfficeButton menu |
visible | "true" | "false" |
Children
This control can contain the following controls
Button | |
CheckBox | |
Gallery | |
Menu | |
Separator | |
SplitButton | |
ToggleButton |
C# Events (design-time)
The splitButton control has a Click event which can be accessed from the Visual Studio Ribbon Designer.
This event is the design-time equivalent of the Click event for its corresponding button.
Callbacks (run-time)
getEnabled | SplitButton_OnGetEnabled - |
getImage | SplitButton_OnGetImage - |
getLabel | SplitButton_OnGetLabel - |
getKeytip | SplitButton_OnGetKeytip - |
getShowImage | SplitButton_OnGetShowImage - |
getShowLabel | SplitButton_OnGetShowLabel - |
getSize | SplitButton_OnGetSize - |
getSupertip | SplitButton_OnGetSupertip - |
getVisible | SplitButton_OnGetVisible - |
© 2024 Better Solutions Limited. All Rights Reserved. © 2024 Better Solutions Limited TopPrevNext