Intersoft ClientUI Documentation
UXRibbonSplitButton Class
Members 



Intersoft.Client.UI.Aqua.UXRibbon Namespace : UXRibbonSplitButton Class
Provides a button control with command and dropdown menu functionality.
Object Model
UXRibbonSplitButton ClassUXContextMenu ClassISFramework ClassStyleSelector ClassDataTemplateSelector ClassStylishLabel Class
Syntax
<TemplateVisualStateAttribute(Name="Pressed", GroupName="CommonStates")>
<DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")>
<TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)>
<StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)>
<TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)>
<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)>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")>
<TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)>
<TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")>
<TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Checked")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")>
Public Class UXRibbonSplitButton 
   Inherits Intersoft.Client.UI.Aqua.UXSplitButton
   Implements Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction 
Dim instance As UXRibbonSplitButton
[TemplateVisualStateAttribute(Name="Pressed", GroupName="CommonStates")]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)]
[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)]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")]
[TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)]
[TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Checked")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
public class UXRibbonSplitButton : Intersoft.Client.UI.Aqua.UXSplitButton, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.IKeyboardFocus, IRibbonControl, IRibbonKeyTipAction  
[TemplateVisualStateAttribute(Name="Pressed", GroupName="CommonStates")]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="LargeState")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="MediumState")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonMenuItem)]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplatePartAttribute(Name="SplitAnimation", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="SplitElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="ContentInside", Type=System.Windows.Controls.ContentControl)]
[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)]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="ButtonMouseOver")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitMouseOver")]
[TemplatePartAttribute(Name="FocusVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="LargeStylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="KeyboardFocus", Type=System.Windows.Shapes.Rectangle)]
[TemplatePartAttribute(Name="DisabledVisualElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="MainContentElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="SizeStates", Name="SmallState")]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Checked")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="SplitButtonPressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
public ref class UXRibbonSplitButton : public Intersoft.Client.UI.Aqua.UXSplitButton, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.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 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

UXRibbonSplitButton Members
Intersoft.Client.UI.Aqua.UXRibbon Namespace

Send Feedback