Back to Devexpress

Quick Access Toolbar

windowsforms-2496-controls-and-libraries-ribbon-bars-and-menu-ribbon-visual-elements-quick-access-toolbar.md

latest2.6 KB
Original Source

Quick Access Toolbar

  • Jan 14, 2025
  • 2 minutes to read

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.OfficeUniversal style.

Quick Access Toolbar Elements

  • Customize Button

  • Item Links

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