Ribbon, Toolbar and Menu Items

Button Item

This toolbar item type allows you to add the following controls onto your toolbars, menus and ribbons:

• Push buttons - you not only can handle item clicks with push buttons, you can also implement "repeat while pressed" functionality;
• Check buttons - in this state, buttons can serve as independent check buttons or can be joined into radio groups;
• Buttons with dropdown controls - the XtraBars Suite provides a special PopupControlContainer control that can be populated with any control and then bound to button items.
• Buttons with dropdown menus - to use this feature, you can bind a popup menu to a button item.

The list below represents the most important features provided by button items:

• Disabled images support;
• Chord shortcuts (you can specify 2 key combinations as the button's shortcut);
• Hints support;
• Control of the button's content when displayed on a toolbar or in a sub menu.

Large Button Item

Being a direct button item descendant, large button items provide the same features and introduces the following unique capabilities:

• You can specify different images to be displayed for large buttons when it is on a toolbar or in a sub menu;
• "Hot" image support;
• Customizable caption alignment.

Sub Menu Item

This item type is needed to build main menus, as well as nested menus. They provide the same settings as button items which are needed to represent the menu's parent item. Additionally, they hold links to items to be displayed within the sub menu and provide settings controlling the sub menu's appearance. Some of the features available to you with sub menu items are as follows:

• Customizable sub menu's width;
• Customizable sub menu's appearance;
• The ability to display a manually painted menu bar.

Edit Item

These items serve as containers for editors from the XtraEditors Library. They allow you to display over 20 different editors within your toolbars and menus including combo boxes, progress bars, date editors, lookup editors, etc.

Static Item

Static items were specifically designed to represent status bar text sections but can also be displayed within a standard toolbar. Its features include:

• Automatic sizing to fit the item's content;
• Automatic sizing to fit the bar's free space;
• Customizable item spacing;
• Customizable text alignment.

Link Container Item

Serves as the container for item links (buttons, menus, etc.), thus allowing you to reuse item sets within multiple toolbars, sub menus, etc. This is useful when you want to display a dynamically changed items list in a toolbar and a sub menu. When using the Link container Item, you will only need to change this item's content - no need to customize both the toolbar and the sub menu.

List Item

List items are used to represent a set of items whose captions are specified via a string list. When on a toolbar, these items act like sub menus. If placed into a sub menu, they are merged with the sub menu's items. Unique features include:

• A specially designed event allowing item clicks handling;
• The ability to display sequential numbers in front of each item;
• The ability to display a check sign in front of the last clicked item;
• Customizable sub menu appearance (useful when placed on a toolbar).

Note that this item's behavior is similar to the MDI Children List item. The difference is that list items allow you to specify the items and handle their clicks in any manner you like.

Toolbars List Item

Designed to represent toolbars and/or dock windows list. All you need to do is place such an item into a sub menu and set its ShowDockWindows and ShowToolbars properties as needed. The item automatically populates itself with the list of toolbars and dock windows where each item can be clicked to change a toolbar's or window's visibility. Additionally, Toolbars List Items can display the Customize... option, which invokes the bars customization window designed for end user toolbar customization.

MDI Children List Item

Displays the list of MDI Children windows and allows you to switch between them by clicking appropriate items. By default, numbers are displayed in front of each item and a check mark indicates the active window. You can disable these features using the item's ShowNumbers and ShowChecks properties.