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
   [Collapse]Bars
    [Collapse]Tutorials
      Add and Remove Toolbars
      Add Bar Items To Toolbars
      Bar Item Links
      Provide Functionality to Bar Items
      Toolbar Customization
      Recently Used Items
      Create Popup Menus
     MDI Merging
    [Expand]Bar Manager Designer
    [Expand]Runtime Customization and Layout Management
    [Expand]Appearance and Hotkeys
   [Expand]Ribbon
   [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

Toolbar Customization

This document explains how to additionally customize your toolbars.

Expanded Hide Toolbars

Toolbar visibility is managed by the Bar.Visible property. The best way of changing bar visibility settings at design time is to right-click the BarManager component and select the "Customize" option to invoke the Customization Window dialog. Then, you can uncheck toolbars that should not be displayed at runtime (you will still see them at design time).

A main menu bar cannot be hidden.

Expanded Dock Toolbars to Container Sides

To dock toolbars to form (user control) sides, drag and drop it to the desired position at design time. Alternatively, select a bar and specify its Bar.DockStyle property in the VS Properties window. Note that the bar will occupy this new location only if the bar's Bar.CanDockStyle property allows it to do so.

When you dock a bar to a container side, you actually place it within a related BarDockControl. The Bar Manager automatically creates four back dock controls docked to all container sides. These containers are only visible when they host a toolbar. Otherwise, their width equals 0.

Those toolbars that are docked to right and left bar dock controls are automatically rotated 90 degrees clockwise. All bar item links are rotated respectively. If you wish to keep horizontal item orientation in a vertically aligned toolbar, set its BarOptions.RotateWhenVertical property to false.

Expanded Make a Toolbar Float

Toolbars that do not belong to any existing BarDockControl (their Bar.DockStyle property is BarDockStyle.None) are represented within floating panels. Such panels display bar names (the Bar.BarName property) and close buttons.

To make a toolbar float at design time, drag and drop it to the desired location. End-users can drag these floating bars around the form and dock them back to BarDockControl containers.

Expanded Add Standalone Toolbars

If you need to display a docked toolbar at any position within the form (user control), utilize StandaloneBarDockControl containers. Add a standalone bar dock control from the VS Toolbox and specify its Dock, Location and Size properties. When it is done, drag a toolbar to this container or specify its Bar.StandaloneBarDockControl property.

Note that standalone bar dock controls require a Bar Manager to be present on a form. If you create a standalone bar dock control manually in code, always add it to the BarManager.DockControls collection.

Expanded Stretch Toolbars

By default, a docked toolbar is sized automatically depending on its content. This allows you to stack multiple toobars side-by-side, as shown below.

If you set the BarOptions.UseWholeRow property to true, a bar will stretch across its entire parent BarDockControl/StandaloneBarDockControl container.

Main menu and status bars have their BarOptions.UseWholeRow properties automatically pre-set to true.

Expanded Hide Secondary Toolbar Elements

End-users customize bars and toolbar layout settings in multiple ways (refer to the Runtime Customization section to learn more). The following list enumerates toolbar settings that affect these features, available to your end-users.

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