Intersoft ClientUI Documentation
UXRibbonSplitButton Class
Members  See Also  Send Feedback
Intersoft.Client.UI.Aqua.UXRibbon Namespace : UXRibbonSplitButton Class






Provides a button control with command and dropdown menu functionality.

Object Model

UXRibbonSplitButton Class

Syntax

Visual Basic (Declaration) 
<TemplateVisualStateAttribute(Name="Checked", GroupName="CommonStates")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")>
<StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")>
<TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="OuterAnimationElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)>
<DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)>
<TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)>
<TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)>
Public Class UXRibbonSplitButton 
   Inherits Intersoft.Client.UI.Aqua.UXSplitButton
   Implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 
Visual Basic (Usage)Copy Code
Dim instance As UXRibbonSplitButton
C# 
[TemplateVisualStateAttribute(Name="Checked", GroupName="CommonStates")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterAnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)]
[TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)]
public class UXRibbonSplitButton : Intersoft.Client.UI.Aqua.UXSplitButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 
JScript 
TemplateVisualStateAttribute(Name="Checked", GroupName="CommonStates")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")
TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")
TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")
StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)
TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")
TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")
TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")
TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")
TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")
TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="OuterAnimationElement", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)
DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")
StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)
TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)
TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)
TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)
TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)
public class UXRibbonSplitButton extends Intersoft.Client.UI.Aqua.UXSplitButton implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 
Managed Extensions for C++ 
[TemplateVisualStateAttribute(Name="Checked", GroupName="CommonStates")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterAnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)]
[TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)]
public __gc class UXRibbonSplitButton : public Intersoft.Client.UI.Aqua.UXSplitButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 
C++/CLI 
[TemplateVisualStateAttribute(Name="Checked", GroupName="CommonStates")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterAnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)]
[TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)]
public ref class UXRibbonSplitButton : public Intersoft.Client.UI.Aqua.UXSplitButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 

Remarks

Derived from UXSplitButton, UXRibbonSplitButton is an advanced button control that represents one or more commands in the form of dropdown menu. This dropdown menu is created using UXContextMenu control which uses UXPopup as its fundamental architecture. To learn more about UXSplitButton, see UXSplitButton Overview.

XAML Copy Code 
<Intersoft:UXRibbonTabGroup Name="NewGroup" Header="New">
    <Intersoft:UXRibbonSplitButton Content="Paste" MinimumSize="Large" 
        LargeIcon="/RibbonSample;component/Assets/Images/Doc/paste.png" 
        Icon="/RibbonSample;component/Assets/Images/Doc/paste.png">
        <Intersoft:UXRibbonMenuItem Header="Paste Special..." />
        <Intersoft:UXRibbonMenuItem Header="Set Default Paste..." />
    </Intersoft:UXRibbonSplitButton>
    <Intersoft:UXRibbonSplitButton Content="New Items" MaximumSize="Medium" 
        LargeIcon="/RibbonSample;component/Assets/Images/Outlook/new_items.png" 
        Icon="/RibbonSample;component/Assets/Images/Outlook/new_items.png">
    </Intersoft:UXRibbonSplitButton>
    <Intersoft:UXRibbonSplitButton Content="Junk" MaximumSize="Medium" 
        LargeIcon="/RibbonSample;component/Assets/Images/Outlook/junk.png" 
        Icon="/RibbonSample;component/Assets/Images/Outlook/junk.png" />
</Intersoft:UXRibbonTabGroup>

The result looks like the following figure.

To learn more about ribbon controls, see Working with Ribbon Controls.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ContentControl
                  System.Windows.Controls.Primitives.ButtonBase
                     System.Windows.Controls.Button
                        Intersoft.Client.Framework.ISButton
                           Intersoft.Client.UI.Aqua.UXButton
                              Intersoft.Client.UI.Aqua.UXButtonItems
                                 Intersoft.Client.UI.Aqua.UXDropDownButton
                                    Intersoft.Client.UI.Aqua.UXSplitButton
                                       Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonSplitButton

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.