New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial
CheckBox Object
The following table lists the most important members of the client-side RadCheckBox object:
Public Properties
Name | Description |
---|---|
get_checked | Returns a bool value, indicating whether the checkbox is checked. |
set_checked | Sets a nullable boolean value that indicates whether the checkbox is checked. When a null value is set, the value will default to false. |
get_enabled | Returns a value, indicating whether the checkbox control is enabled. |
set_enabled | Sets whether the checkbox is enabled. |
get_text | The text displayed in the RadCheckBox control. |
set_text | Sets the text displayed in the RadCheckBox control. |
get_toolTip | Gets the text displayed when the mouse pointer hovers over the RadCheckBox control. |
set_toolTip | Sets the text displayed when the mouse pointer hovers over the RadCheckBox control. |
get_uniqueID | Gets the unique, hierarchically qualified identifier for the RadCheckBox control. |
get_textElement | Gets a reference to the HTML element that holds the text of the RadCheckBox control. |
get_cssClass | Gets the Cascading Style Sheet (CSS) class rendered by the RadCheckBox control on the client. |
get_disabledCssClass | Gets the CSS class applied when the control is disabled. |
get_hoveredCssClass | Gets the CSS class applied to the RadCheckBox control when the mouse pointer is over the control. |
get_pressedCssClass | Gets the CSS class applied to the RadCheckBox control when the control is pressed. |
get_commandName | Gets the command name associated with the RadCheckBox control that is passed to the Command event. |
set_commandName | Sets the command name associated with the RadCheckBox control that is passed to the Command event. |
get_commandArgument | Gets an optional parameter passed to the Command event along with the associated CommandName. |
set_commandArgument | Sets an optional parameter passed to the Command event along with the associated CommandName. |
get_autoPostBack | Gets a bool value indicating whether the RadCheckBox control automatically posts back to the server when clicked. |
set_autoPostBack | Sets a bool value indicating whether the RadCheckBox control automatically posts back to the server when clicked. |
get_height | Gets the height of the RadCheckBox control. |
get_width | Gets the width of the RadCheckBox control. |
get_visible | Gets a bool value indicating whether the checkbox is visible. |
set_visible | Shows/hides the checkbox. |
get_validationGroup | Gets the name of ValidationGroup to which RadCheckBox is assigned. |
set_validationGroup | Sets the validation group to which RadCheckBox should be assigned. |
Public Methods
Name | Description |
---|---|
focus | Brings the focus to the RadCheckBox control. |
click | Executes programmatic checkbox click. Accepts an optional boolean parameter that specifies whether the client-side clicking event of RadCheckBox will be fired when the control is clicked programmatically. If the function is called without parameter, the clicking event will not be fired. |
Methods for Modifying Client-side Event Handlers Dynamically
Name | Description |
---|---|
add_load | The name of the JavaScript function called when the control loads. |
remove_load | Removes a handler for the load event. |
add_clicking | The name of the JavaScript function called when the RadCheckBox control is clicked. |
remove_clicking | Removes a handler for the clicking event. |
add_checkedChanging | The name of the JavaScript function called before the checked state of the checkbox is changed. |
remove_checkedChanging | Removes a handler for the checkedChanging event. |
add_checkedChanged | The name of the JavaScript function called when the checked state of the checkbox is changed. |
remove_checkedChanged | Removes a handler for the checkedChanged event. |
add_clicked | The name of the JavaScript function called when the RadCheckBox control is clicked. |
remove_clicked | Removes a handler for the clicked event. |
add_mouseOver | The name of the JavaScript function called when the mouse hovers over the control. |
remove_mouseOver | Removes a handler for the mouseOver event. |
add_mouseOut | The name of the JavaScript function when the mouse leaves the control. |
remove_mouseOut | Removes a handler for the mouseOut event. |
You can read more on the subject in the Setting Client Event Handlers by Using JavaScript help article.