Edit this page

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.

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