RadControls for ASP.NET AJAX 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.
Note |
|---|
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:
See Also