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

Setting Event Handlers via JavaScript

You can use the client-side API of the RadImageButton control to modify the event handlers it calls.

To handle the desired event, the user should 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 a handler that has been added previously, the respective remove_(handlerFunction) should be used.

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

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

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

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

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

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

<script type="text/javascript">
function removeEvents()
{
    var button = $find("<%= RadImageButton1.ClientID %>");
    button.remove_show(Click);
}
</script>

Public Properties

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 RadImageButton control is clicked.
.remove_clicking() Removes a handler for the clicking event.
.add_clicked() The name of the JavaScript function called when the RadImageButton 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