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






Provides a container for a collection of groups, commands or controls.

Object Model

UXToolBar Class

Syntax

Visual Basic (Declaration) 
<DescriptionAttribute("Provides a container for a collection of groups, commands or controls.")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXToolBarButton)>
<TemplatePartAttribute(Name="OverflowButton", Type=Intersoft.Client.UI.Aqua.UXToolBarButton)>
<TemplatePartAttribute(Name="OverflowContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)>
<TemplatePartAttribute(Name="OverflowMenuContainer", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="GripContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)>
<TemplatePartAttribute(Name="GripHandle", Type=System.Windows.Shapes.Path)>
<TemplatePartAttribute(Name="ToolStripBackground", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="ToolStripPresenter", Type=System.Windows.Controls.ItemsPresenter)>
Public Class UXToolBar 
   Inherits Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl
   Implements IControl, IFramework, ILicensing, IDropable 
Visual Basic (Usage)Copy Code
Dim instance As UXToolBar
C# 
[DescriptionAttribute("Provides a container for a collection of groups, commands or controls.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowButton", Type=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="OverflowMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GripContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="GripHandle", Type=System.Windows.Shapes.Path)]
[TemplatePartAttribute(Name="ToolStripBackground", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="ToolStripPresenter", Type=System.Windows.Controls.ItemsPresenter)]
public class UXToolBar : Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl, IControl, IFramework, ILicensing, IDropable 
JScript 
DescriptionAttribute("Provides a container for a collection of groups, commands or controls.")
StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXToolBarButton)
TemplatePartAttribute(Name="OverflowButton", Type=Intersoft.Client.UI.Aqua.UXToolBarButton)
TemplatePartAttribute(Name="OverflowContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)
TemplatePartAttribute(Name="OverflowMenuContainer", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="GripContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)
TemplatePartAttribute(Name="GripHandle", Type=System.Windows.Shapes.Path)
TemplatePartAttribute(Name="ToolStripBackground", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="ToolStripPresenter", Type=System.Windows.Controls.ItemsPresenter)
public class UXToolBar extends Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl implements IControl, IFramework, ILicensing, IDropable 
Managed Extensions for C++ 
[DescriptionAttribute("Provides a container for a collection of groups, commands or controls.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowButton", Type=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="OverflowMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GripContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="GripHandle", Type=System.Windows.Shapes.Path)]
[TemplatePartAttribute(Name="ToolStripBackground", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="ToolStripPresenter", Type=System.Windows.Controls.ItemsPresenter)]
public __gc class UXToolBar : public Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl, IControl, IFramework, ILicensing, IDropable 
C++/CLI 
[DescriptionAttribute("Provides a container for a collection of groups, commands or controls.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowButton", Type=Intersoft.Client.UI.Aqua.UXToolBarButton)]
[TemplatePartAttribute(Name="OverflowContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="OverflowMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GripContainer", Type=Intersoft.Client.UI.Controls.ContentTransformer)]
[TemplatePartAttribute(Name="GripHandle", Type=System.Windows.Shapes.Path)]
[TemplatePartAttribute(Name="ToolStripBackground", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="ToolStripPresenter", Type=System.Windows.Controls.ItemsPresenter)]
public ref class UXToolBar : public Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl, IControl, IFramework, ILicensing, IDropable 

Remarks

You use UXToolBar to host a collection of command buttons which typically represented as a bar-like interface docked in the top edge of the screen. UXToolBar sports a built-in professional style that is suitable for business and productivity applications such as editing form or Office-like applications. 

UXToolBar is designed with modern user interface that comprises of three main parts, a handle for dragging purpose, a container that host the commands, and an overflow handle to access commands being hidden due to insufficient screen real estate.

The following illustration shows a simple tool bar that is built with UXToolBar control.

Depending on your UI scenarios, you can use either UXToolGroup or UXToolBarButton as the item of the tool bar. The following sections describe the overview of UXToolGroup and UXToolBarButton, and how they are used along with the UXToolBar.

The following example shows how to create a UXToolBar with two UXToolGroup instances.

XAML Copy Code 
 <Intersoft:UXToolBar>

     <Intersoft:UXToolGroup>
         <Intersoft:UXToolBarButton Content="Save Changes" 
                                    DisplayMode="ContentAndImage" 
                                    Icon="/Assets/Images/Commands/Save.png"
                                    Command="{Binding Path=SaveCommand}" />
         <Intersoft:UXToolBarButton Content="Cancel" 
                                    DisplayMode="ContentAndImage" 
                                    Icon="/Assets/Images/Commands/Cancel.png"/>
     </Intersoft:UXToolGroup>

     <Intersoft:UXToolGroup Placement="RightOrBottom">
         <Intersoft:UXToolBarButton Content="Help" 
                                    DisplayMode="Image" 
                                    Icon="/Assets/Images/Commands/Help.png" />
         <Intersoft:UXSeparator/>
         <Intersoft:UXToolBarButton Content="More Actions" 
                                    ButtonType="DropdownButton">
             <Intersoft:UXMenuItem Header="Schedule a meeting" />
         </Intersoft:UXToolBarButton>
     </Intersoft:UXToolGroup>

 </Intersoft:UXToolBar>

The result looks like the following figure.

As seen in the above illustration, UXToolGroup makes it easy for you to partition your commands into multiple logical groups. It also provides efficient ways to use different placement settings, which is something difficult or impossible to achieve using the traditional tool bar.

For more information about UXToolGroup and its features, see UXToolGroup Overview. 

For more information about UXToolBar and its features, see UXToolBar Overview.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ItemsControl
                  Intersoft.Client.Framework.ISItemsControl
                     Intersoft.Client.UI.Controls.Interactivity.ISDragableItemsControl
                        Intersoft.Client.UI.Aqua.UXToolBar
                           Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonQuickAccessToolBar

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.