OnClientClicking
The clicking event occurs when the RadPushButton 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 RadPushButton 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 RadPushButton's CommandName property
-
get_commandArgument() - returns the value assigned to the RadPushButton'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 RadPushButton.
<script type="text/javascript">
function Clicking(sender, args)
{
args.set_cancel(!window.confirm("Are you sure you want to submit the page?"));
}
</script>
<telerik:RadPushButton ID="RadPushButton1" runat="server" Text="Submit" OnClientClicking="Clicking" OnClick="RadPushButton1_Click">
</telerik:RadPushButton>protected void RadPushButton1_Click(object sender, System.EventArgs e)
{
RadPushButton1.Text = "RadPushButton was clicked at: " + DateTime.Now.ToString();
}