Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Collapse]Ribbon, Bars and Menu
   [Expand]Bars
   [Collapse]Ribbon
    [Expand]The Ribbon UI
    [Collapse]Visual Elements
      Ribbon Page
      Ribbon Page Group
      Categories and Contextual Tabs
      Quick Access Toolbar
      Page Header Items
      Application Button
    [Expand]Items and Item Links
     Ribbon Styles
    [Expand]Galleries
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Expand]Runtime Capabilities
    [Expand]Miscellaneous
     Known Issues
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
   [Expand]Examples
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Quick Access Toolbar

The Ribbon Quick Access Toolbar is a customizable element that is designed to provide end-users with one-click access to the most important and used features. It is represented by the RibbonQuickAccessToolbar class.

By default, this toolbar is displayed above the Ribbon Control. Its location can be changed using the RibbonControl.ToolbarLocation property.

Note

The Ribbon Quick Access Toolbar is unavailable in the RibbonControlStyle.TabletOfficeEx and RibbonControlStyle.OfficeUniversal styles.

Expanded Quick Access Toolbar Elements

  • Customize Button

    When an end-user clicks this button, the drop down menu is displayed. This menu allows end-users to change the location of the Quick Access Toolbar and the visibility of item links within.

    The visibility of the Customize Button is specified by the RibbonQuickAccessToolbar.ShowCustomizeItem property.

  • Item Links

    End-users can add links to the desired bar items by right-clicking them and choosing "Add to Quick Access Toolbar" from the context menu.

    The collection of item links that are displayed within the toolbar can be accessed in code using the RibbonQuickAccessToolbar.ItemLinks property. This collection allows you to add, remove and access individual item links. To manage this collection at design time, use the Designer.

Expanded Saving and Restoring Layout

The Quick Access Toolbar supports runtime customization. An end-user can add bar commands displayed within Ribbon page groups to the Toolbar using context menus. However, runtime changes to the Toolbar are not saved between application runs. The layout of bar commands within the Toolbar must be saved, and then restored manually. To save the layout of bar commands within the Toolbar, call one of the SaveLayoutTo... methods provided by the RibbonQuickAccessToolbar object. These are the RibbonQuickAccessToolbar.SaveLayoutToRegistry, RibbonQuickAccessToolbar.SaveLayoutToStream and RibbonQuickAccessToolbar.SaveLayoutToXml methods. To restore the saved layout later, call a corresponding RestoreLayoutFrom... method (RibbonQuickAccessToolbar.RestoreLayoutFromRegistry, RibbonQuickAccessToolbar.RestoreLayoutFromStream or RibbonQuickAccessToolbar.RestoreLayoutFromXml).

How would you rate this topic?​​​​​​​