Events Overview
RadCheckBox exposes several client-side events that allow easy and flexible use in a wide range of application scenarios:
-
OnClientLoad (load) - raised when the control is initialized.
-
OnClientClicking (clicking) - raised when the user clicks the checkbox. The event can be canceled.
-
OnClientClicked (clicked) - raised when the checkbox is clicked. The event is subsequent to the OnClientCheckedChanged event.
-
OnClientCheckedChanging (checkedChanging) - raised after the user clicks the checkbox and before the checked state is changed. The event can be canceled and it is subsequent to the OnClientCheckedChanged event.
-
OnClientCheckedChanged (checkedChanged) - raised when the checked state of the checkbox is changed. The event is subsequent to the OnClientCheckedChanging event.
-
OnClientMouseOver (mouseOver) - raised when the mouse hovers over the control.
-
OnClientMouseOut (mouseOut) - raised when the mouse leaves the control.
To handle the desired event, the user must set the respective property to the name of the JavaScript function handling the event or to an anonymous JavaScript function. Here is an example:
Example 1: Passing a named (non-anonymous) JavaScript function.
<script type="text/javascript">
function Click(sender, args)
{
alert("RadCheckBox was clicked.");
}
</script>
<telerik:RadCheckBox ID="RadCheckBox1" Text="Check here" runat="server" OnClientClicked="Click">
</telerik:RadCheckBox>
RadCheckBox1.OnClientClicked = "Click"; //passing the name of the JS function
Example 2: Passing an anonymous JavaScript function.
<script type="text/javascript">
function Click(button, args, arg1, arg2)
{
alert("arg1:" + arg1 + " arg2:" + arg2);
}
</script>
<telerik:RadCheckBox ID="RadCheckBox1" Text="Check here" runat="server" OnClientClicked="function(sender,args){Click(sender, args, 'Value1', 'Value2');}">
</telerik:RadCheckBox>
RadCheckBox1.OnClientClicked = "function(sender,args){Click(sender, args, 'Value1', 'Value2');}"; //passing an anonymous JS function