OnClientClicked
The clicked event is subsequent to the clicking event, and occurs when the RadImageButton control is clicked. The event is fired after the client-side validation is completed, just before the page is submitted, and cannot be canceled.
The event handler receives two parameters:
The instance of the clicked RadImageButton control.
-
An eventArgs parameter of type Telerik.Web.UI.ButtonEventArgs, containing the following properties and methods:
get_commandName() - returns the value assigned to the RadImageButton's CommandName property
get_commandArgument() - returns the value assigned to the RadImageButton's CommandArgument property
This event should be used in scenarios where the user needs to execute custom client-side code when the button is clicked. Since validation has occurred, the page can be checked for validity before any client code is executed. This is exactly what the following example is doing: it checks for a valid URL, and if a valid one is entered, it opens it in a RadWindow control. Here is the code:
Example 1: RadImageButton handling the OnClientClicked event.
<script type="text/javascript">
function OpenWindow(sender, args)
{
if (Page_IsValid)
{
var RadWindow = $find("<%=RadWindow1.ClientID%>");
RadWindow.setUrl($get("Textbox1").value);
RadWindow.show();
}
else
{
alert("The page is not valid. Please enter a valid URL.");
}
}
</script>
<span>URL:</span>
<asp:TextBox ID="Textbox1" runat="server" />
<asp:RegularExpressionValidator ID="regNavaigateUrl" runat="server" ForeColor="Red"
ControlToValidate="Textbox1" ValidationGroup="UrlVG" SetFocusOnError="true"
ValidationExpression="http(s)?://([\w-]+\.)+[\w-]+(/[\w- ./?%&=]*)?"
ErrorMessage="Valid URL should start with <strong>http://</strong>">
</asp:RegularExpressionValidator>
<br />
<telerik:RadImageButton id="RadImageButton1" runat="server" text="Open Window" OnClientClicked="OpenWindow"
ValidationGroup="UrlVG" AutoPostback="false">
</telerik:RadImageButton>
<telerik:RadWindow RenderMode="Lightweight" id="RadWindow1" runat="server">
</telerik:RadWindow>