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






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

Object Model

UXRibbonQuickAccessToolBar Class

Syntax

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

Remarks

UXRibbonQuickAccessToolbar is a ribbon-friendly control that provides quick access to frequently accessed commands such as New, Open, Save and Print. You can hide the commands initially by setting the Visibility property to Collapsed. At runtime, users can show the hidden commands through the dropdown menu in the quick access toolbar.

By default, the position of UXRibbonQuickAccessToolbar is set to the top of UXRibbonBar. If you prefer, you can set the position to the bottom by setting the ToolBarPosition property to Bottom.

UXRibbonQuickAccessToolbar derives from UXToolbar which is an advanced, rich-featured toolbar control with elegant built-in styles and built-in support for various button types such as described below.

  • Button

    Represents a standard command button.

  • DropdownButton

    Represents a button that displays dropdown menu when clicked, which can contain a collection of menu items and nested menu items similar to UXContextMenu.

  • SplitButton

    Represents a combination of command button and a dropdown menu. This type of button typically provides users with a default command that executed when the command part of the button is clicked, while at the same time allowing users to choose alternative commands through the dropdown arrow. Similar to the DropdownButton, you can also define a collection of menu items and nested menu items as in UXContextMenu.

  • Custom

    Represents a custom button that can be used to contain any UIElement or controls. With this type, the default layout properties such as margin and padding as well as the UI behaviors would be disabled. Consequently, this type is ideal to host custom controls such as text box, combo box, date picker and others.

The following code shows how to add UXRibbonQuickAccessToolbar to the ribbon control with several buttons using different button type.

XAML Copy Code 
<Intersoft:UXRibbonBar.QuickAccessToolBar>
    <Intersoft:UXRibbonQuickAccessToolBar>
        <Intersoft:UXRibbonToolBarButton DisplayMode="Image" Content="New" Icon="/assets/icons/new.png" />
        <Intersoft:UXRibbonToolBarButton DisplayMode="Image" Content="Open" Icon="/assets/icons/openfolder.png" />
        <Intersoft:UXRibbonToolBarButton DisplayMode="Image" Content="Save" Icon="/assets/icons/save.png" />
        <Intersoft:UXSeparator />
        <Intersoft:UXRibbonToolBarButton Visibility="Collapsed" DisplayMode="Image" Content="Meeting" Icon="/assets/icons/meeting.png" IsToggleButton="True" />
        <Intersoft:UXRibbonToolBarButton DisplayMode="Image" Content="More" Icon="/assets/icons/more.png" />
        <Intersoft:UXRibbonToolBarButton ButtonType="DropdownButton" DisplayMode="Image" Content="Clean Up" Icon="/assets/icons/clean_up.png">
            <Intersoft:UXRibbonMenuItem Header="Clean Up Conversation" />
            <Intersoft:UXRibbonMenuItem Header="Clean Up Folder" />
            <Intersoft:UXRibbonMenuItem Header="Clean Up Folder & Subfolders" />
        </Intersoft:UXRibbonToolBarButton>
        <Intersoft:UXRibbonToolBarButton ButtonType="SplitButton" DisplayMode="Image" Content="Find" Icon="/assets/icons/find.png">
            <Intersoft:UXRibbonMenuItem Header="Find" Icon="/assets/icons/find.png" />
            <Intersoft:UXRibbonMenuItem Header="Advanced Find..." Icon="/assets/icons/find.png" />
            <Intersoft:UXRibbonMenuItem Header="Go To..." />
        </Intersoft:UXRibbonToolBarButton>
    </Intersoft:UXRibbonQuickAccessToolBar>
</Intersoft:UXRibbonBar.QuickAccessToolBar>

The result looks like the following figure.

To learn more about UXRibbonQuickAccessToolBar, see Working with Ribbon Quick Access Toolbar.

Using Commands in Quick Access Toolbar

The following example shows how to assign a command to a UXRibbonToolBarButton which will be executed when the item is pressed.

XAML Copy Code 
<Intersoft:UXRibbonToolBarButton Content="Add new task" Command="{Binding AddNewTaskCommand}" />

For more information about the basics of commanding concept, see Commanding 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.