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

OnClientCommand

The OnClientCommand event fires when a command button from the RadWindow's title bar is clicked or tapped by the user. The developer can also initiate it by using the client-side API of the control(e.g., the minimize(), maximize(), restore(), togglePin() and reload() methods). You can cancel this event to prevent the command from executing (Example 1).

The event handler receives the following arguments:

  1. The RadWindow object that fired the event.

  2. An event arguments object that exposes the following methods:

Name Parameters Return Type Description
get_cancel boolean Gets a value indicating whether the event is going to be cancelled.
get_commandName string This is the name of the command that was initiated.
set_cancel boolean Sets a value indicating whether the event is going to be cancelled. Pass true to cancel the event. The method takes the following arguments: boolean—a value that indicates whether the event is to be cancelled.

Example 1: Getting the command and cancelling its execution according to a condition.

<telerik:RadWindow RenderMode="Lightweight" runat="server" ID="RadWindow1" OnClientCommand="OnClientCommandHandler" VisibleonPageLoad="true"></telerik:RadWindow>
<script type="text/javascript">
    function OnClientCommandHandler(sender, args) {
        var command = args.get_commandName(); //get the initiated command
        if (command == "Reload") {
            args.set_cancel(true); //prevent reloading
        }
    }
</script>

See Also

In this article