New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

Setting Event Handlers via JavaScript

RadCheckBox API exposes client-side methods to attach and detach functions to its event. They can be used as an alternative to the server-side properties for handling events.

To handle the desired event, you can use the respective add_(handlerFunction) to attach the desired handler (i.e., add_clicked for the clicked event), where the parameter handlerFunction should be of type function. To remove the handler that has been added previously, the respective remove_(handlerFunction) should be used.

The next three examples show how to add and remove handlers on the client:

Example 1: Adding a named (non-anonymous) JavaScript click handler to RadCheckBox.

<script type="text/javascript">
    function Click(checkbox, args)
    {
        alert("Checkbox was clicked");
    }
    function addHandler()
    {
        var checkBox = $find("<%=RadCheckBox1.ClientID %>");
        checkBox.add_clicked(Click);
    }
</script>

Example 2: Adding an anonymous JavaScript click handler to RadCheckBox.

<script type="text/javascript">
    function Click(checkbox, args, arg1)
    {
        alert("Checkbox was clicked. arg1: " + arg1);
    }
    function addHandler()
    {
        var checkBox = $find("<%=RadCheckBox1.ClientID %>");
        checkBox.add_clicked(function (checkbox, args) { Click(checkbox, args, "Value1") });
    }
</script>

Example 3: Removing the JavaScript click handler of a RadCheckBox.

function removeEvents()
{
    var checkBox = $find("<%= RadCheckBox1.ClientID %>");
    checkBox.remove_click(Click);
}

Table 1: Available add/remove methods for handling client-side events.

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.

See Also

In this article