RadToolBar Items Overview
RadToolBar Items can be buttons, drop-downs or split buttons. The sections below describe the most important properties of the three item-types.
RadToolBarButton
The RadToolBarButton has a few important properties, which are listed below:
Text is the string that the user sees for the button.
ToolTip is the text of the tooltip that appears when the user hovers the mouse over the button.
Setting the tooltip can enable an accessibility feature: Special accessibility readers like JAWS can pronounce the tooltip of the highlighted item.
Value is the value associated with the button.
CommandName and CommandArgument let you associate a command with the button.
CheckOnClick indicates whether the button has two states: "checked" and "unchecked". When CheckOnClick is True, the user can change the state to "checked" by clicking on the button.
Checked indicates whether the button is checked. A button can be checked only if the CheckOnClick property is set to True.
Group lets you group toolbar buttons together so that they act like radio buttons.
AllowSelfUnCheck lets the user turn off the checked state of a button by clicking. This property should not be set to True if the button is used in a group.
Enabled determines whether the user can click the button to perform some task.
IsSeparator turns the button into a separator. Separators do not perform a task, but simply act to make visual distinctions in the layout of buttons in the toolbar or a drop-down list.
CssClass is the name of a CSS style to be applied to the button. The style can be declared in the CSS file of the applied skin.
In addition to the built-in properties, you can add your own custom attributes to the toolbar buttons to expand their functionality.
RadToolBarDropDown
The RadToolBarDropDown object exposes a Buttons collection. In other words, the RadToolBarDropDown can contain RadToolBarButtons. Below are listed some of the most important properties of the RadToolBarDropDown:
Text is the string that the user sees for the drop-down.
Enabled indicates whether the user can expand/collapse the drop-down.
Visible indicates whether the drop-down is visible or not.
CssClass is the name of the CSS style to be applied to the drop-down. The style can be declared in the CSS file of the applied skin.
ToolTip is the text of the tooltip that appears when the user hovers the mouse over the drop-down.
In addition to the built-in properties, you can add your own custom attributes to drop-downs to expand their functionality.
RadToolBarSplitButton
The RadToolBarSplitButton object also exposes a Buttons collection.
Text is the string that the user sees for the split button.
EnableDefaultButton lets you specify a button in the split button's Buttons collection that acts as a default button. When the split button has a default button, it displays the Text and image of the default button rather than the values assigned to its own Text and image properties.
DefaultButtonIndex identifies which button in the Buttons collection is the default button when the EnableDefaultButton property is True.
Value is the value associated with the split button.
CommandName and CommandArgument let you associate a command with the split button.
Enabled indicates whether the user can click/expand/collapse the split button.
Visible indicates whether the split button is visible or not.
CssClass is the name of the CSS style to be applied to the split button. The style can be declared in the CSS file of the applied skin.
ToolTip is the text of the tooltip that appears when the user hovers the mouse over the split button.
In addition to the built-in properties, you can add your own custom attributes to split buttons to expand their functionality.
Controlling what items appear
There are a number of ways you can control the buttons that RadToolBar holds. You can:
Specify the buttons in-line at design time.
Load the items from an XML file.
Bind the toolbar to a data source.
Add, remove, and edit the items in the toolbar in server-side code.