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)

getEnabledSplitButton_OnGetEnabled -
getImageSplitButton_OnGetImage -
getLabelSplitButton_OnGetLabel -
getKeytipSplitButton_OnGetKeytip -
getShowImageSplitButton_OnGetShowImage -
getShowLabelSplitButton_OnGetShowLabel -
getSizeSplitButton_OnGetSize -
getSupertipSplitButton_OnGetSupertip -
getVisibleSplitButton_OnGetVisible -


© 2024 Better Solutions Limited. All Rights Reserved. © 2024 Better Solutions Limited TopPrevNext