OnClientClicking
The clicking event occurs when the RadSplitButton control is clicked, immediately after the mouse button is released. The event is fired after the client-side validation occurs, and can be canceled.
The event handler receives two parameters:
-
The instance of the clicked RadSplitButton control
-
An eventArgs parameter of type Telerik.Web.UI.ButtonCancelEventArgs, containing the following properties and methods:
-
get_cancel() - returns a bool value that indicates whether the event was canceled. True means the event is canceled.
-
set_cancel(shouldCancel) - sets a bool value that indicates whether the event will be canceled. Setting true means the event will be canceled.
-
get_commandName() - returns the value assigned to the RadSplitButton's CommandName property
-
get_commandArgument() - returns the value assigned to the RadSplitButton's CommandArgument property
-
This event comes handy in scenarios when the user wants to cancel the page submission, or prevent execution of the other client-side events based on a certain condition. One such scenario is confirming the submission of the page to the server. We ask the user if she wants to submit the page, and if a negative answer is received, we cancel the clicking event. Here is the code:
Example 1: Handling OnClientClicking event in RadSplitButton.
<script type="text/javascript">
function Clicking(sender, args)
{
args.set_cancel(!window.confirm("Are you sure you want to submit the page?"));
}
</script>
<telerik:RadSplitButton ID="RadSplitButton1" runat="server" Text="Submit" OnClientClicking="Clicking" OnClick="RadSplitButton1_Click">
</telerik:RadSplitButton>protected void RadSplitButton1_Click(object sender, System.EventArgs e)
{
RadSplitButton1.Text = "RadSplitButton was clicked at: " + DateTime.Now.ToString();
}