[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [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
     MDI Merging
    [Collapse]Bar Manager Designer
      Toolbars Page
      Categories Page
      Paint Styles Page
      Repository Editor Page
      Saving And Restoring Layout Pages
      Invoke Bar Manager Designer
    [Expand]Runtime Customization and Layout Management
    [Expand]Appearance and Hotkeys
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst 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]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Categories Page

The Categories page provides category management facilities. It includes buttons used to add and remove categories, a tree view displaying the categories with their items, a property grid that allows access to the selected category's (item's) settings. This page is shown in the image below.


Categories are stored in the BarManager's BarManager.Categories collection. This collection is managed using the buttons located at the top of the page. The list below briefly describes these buttons:

  • Add New Category - creates a new category and appends it to the end of the collection. Clicking this button invokes the message box where you should type the new category's name. You can also press the INSERT key to create a new category.
  • Delete Toolbar - removes the selected category from the collection. After the category has been removed, all its items are automatically moved to the default category ("Unassigned items"). You can also press the DELETE key to remove the selected category from the collection. Note the default category can not be removed.

Items can be moved from one category to another using drag and drop. A green arrow () will be shown pointing to the category the selected item is moved to. Note that items can not be moved to the default category ("Unassigned items"). Items are automatically moved to this category when their owning category is removed.

The property grid located at the right side of the page gives you the ability to customize the selected category's (item's) settings. For more information on categories refer to the How To: Organize Bar Items into Categories topic.

Expanded See Also

Is this topic helpful?​​​​​​​