RadControls for Silverlight
Contents

The RadRibbonSplitButton represents an extension of the RadSplitButton. It provides an easier interaction with the RadRibbonBar control. What is special about the RadRibbonSplitButton is that it is separated into two areas. The first one exposes a default action for the button while the second one pops up the drop down content like the RadRibbonDropDownButton does. This means that the user does not need to open the popup area every time he needs to select an action, he can just select the one exposed directly by the button.

Tip
To learn more about the RadRibbonSplitButton control read its documentation.

Here is a sample definition of a RadRibbonSplitButton without having any drop down content defined:

CopyXAML
<telerik:RadRibbonSplitButton Text="Paste"
                              SmallImage="/Icons/16/paste.png"
                              LargeImage="/icons/32/paste.png"
                              Size="Large" />
Tip
As all buttons in the RadRibbonBar's set slightly expose the same functionality, take a look at the Common functionality section in the Overview topic.

This button has its initial size set to Large andits text label set to "Paste".

Setting the Drop Down Content

To set the popup content you have to simply set the DropDownContent property of the button. Here is an example of a RadRibbonGroup that contains single RadRibbonSplitButton with three menu items inside its drop down.

CopyXAML
<telerik:RadRibbonSplitButton Text="Paste"
                              SmallImage="/Icons/16/paste.png"
                              LargeImage="/Icons/32/paste.png"
                              Size="Large">
    <telerik:RadRibbonSplitButton.DropDownContent>
        <telerik:RadContextMenu BorderThickness="0">
            <telerik:RadMenuItem Header="Paste">
                <telerik:RadMenuItem.Icon>
                    <Image Source="/Icons/16/paste.png" />
                </telerik:RadMenuItem.Icon>
            </telerik:RadMenuItem>
            <telerik:RadMenuItem Header="Paste Special...">
                <telerik:RadMenuItem.Icon>
                    <Image Source="/Icons/16/pastespecial.png" />
                </telerik:RadMenuItem.Icon>
            </telerik:RadMenuItem>
            <telerik:RadMenuItem Header="Paste as Hyperlink"
                                 IsEnabled="False">
                <telerik:RadMenuItem.Icon>
                    <Image Source="/Icons/16/pastehyperlink.png" />
                </telerik:RadMenuItem.Icon>
            </telerik:RadMenuItem>
        </telerik:RadContextMenu>
    </telerik:RadRibbonSplitButton.DropDownContent>
</telerik:RadRibbonSplitButton >

Handling the Drop Down Events

Besides the Click event, the RadRibbonSplitButton exposes several drop down related events:

  • DropDownClosed - fires after the popup area has been closed.
  • DropDownOpening - fires before the popup area gets opened.
  • DropDownOpend - fires after the popup area has been opened.
CopyXAML
<telerik:RadRibbonSplitButton Text="Paste"
                                 ...
                              DropDownClosed="RadRibbonSplitButton_DropDownClosed"
                              DropDownOpened="RadRibbonSplitButton_DropDownOpened"
                              DropDownOpening="RadRibbonSplitButton_DropDownOpening">
CopyC#
private void RadRibbonSplitButton_DropDownClosed( object sender, RoutedEventArgs e )
{
}
private void RadRibbonSplitButton_DropDownOpened( object sender, RoutedEventArgs e )
{
}
private void RadRibbonSplitButton_DropDownOpening( object sender, RoutedEventArgs e )
{
}
CopyVB.NET
Private Sub RadRibbonSplitButton_DropDownClosed(sender As Object, e As RoutedEventArgs)
End Sub
Private Sub RadRibbonSplitButton_DropDownOpened(sender As Object, e As RoutedEventArgs)
End Sub
Private Sub RadRibbonSplitButton_DropDownOpening(sender As Object, e As RoutedEventArgs)
End Sub
Tip
To learn how to handle ribbon bar button clicks take a look at the Handling the Button Clicks section from the Buttons Overview topic.

Customizing the RibbonSplitButton

To learn how to change the default appearance of the RibbonSplitButton read this topic.

See Also