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






Provides a lightweight split button control.

Object Model

UXSplitButton Class

Syntax

Visual Basic (Declaration) 
<ContentPropertyAttribute("Items")>
<DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXMenuItem)>
Public Class UXSplitButton 
   Inherits UXDropDownButton
   Implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus 
Visual Basic (Usage)Copy Code
Dim instance As UXSplitButton
C# 
[ContentPropertyAttribute("Items")]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXMenuItem)]
public class UXSplitButton : UXDropDownButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus 
Delphi 
public class UXSplitButton = class(UXDropDownButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus)
JScript 
ContentPropertyAttribute("Items")
DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")
StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXMenuItem)
public class UXSplitButton extends UXDropDownButton implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus 
Managed Extensions for C++ 
[ContentPropertyAttribute("Items")]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXMenuItem)]
public __gc class UXSplitButton : public UXDropDownButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus 
C++/CLI 
[ContentPropertyAttribute("Items")]
[DescriptionAttribute("Provides a button control with command and dropdown menu functionality.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXMenuItem)]
public ref class UXSplitButton : public UXDropDownButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus 

Example

XAML Copy Code 
<Intersoft:UXSplitButton Content="View Products" HorizontalAlignment="Left" VerticalAlignment="Top">
    <Intersoft:UXMenuItem Header="Beverages">
        <Intersoft:UXMenuItem Header="Ikura"/>
        <Intersoft:UXMenuItem Header="Konbu"/>
        <Intersoft:UXMenuItem Header="Carnarvon Tigers"/>
        <Intersoft:UXMenuItem Header="Escargots de Bourgogne"/>
    </Intersoft:UXMenuItem>
    <Intersoft:UXMenuItem Header="Seafood">
        <Intersoft:UXMenuItem Header="Chai"/>
        <Intersoft:UXMenuItem Header="Chang"/>
        <Intersoft:UXMenuItem Header="Sasquatch Ale"/>
        <Intersoft:UXMenuItem Header="Ipoh Coffee"/>
    </Intersoft:UXMenuItem>
</Intersoft:UXSplitButton>

Remarks

UXSplitButton 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.

Consequently, the dropdown menu of UXSplitButton has the identical features that UXPopup provides such as positioning, hide and display animation, etc.

To learn more about the popup concept, see Popup Overview.

The following example shows how to create a UXSplitButton with several menu items.

XAML Copy Code 
<Intersoft:UXSplitButton Content="Button" HorizontalAlignment="Center" VerticalAlignment="Center" PreferredPosition="BottomRight" PreferredVerticalDirection="Up">
        <Intersoft:UXMenuItem Header="UXMenuItem"/>
        <Intersoft:UXMenuItem Header="UXMenuItem"/>
        <Intersoft:UXMenuItem Header="UXMenuItem"/>
        <Intersoft:UXMenuItem Header="UXMenuItem"/>
        <Intersoft:UXMenuItem Header="UXMenuItem"/>
</Intersoft:UXSplitButton>

To learn more about UXSplitButton, see UXSplitButton Overview.

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
                                       Intersoft.Client.UI.Aqua.UXToolBarButton

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.