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

OnClientFilter

The client-side Filter event is raised when the user filters the files in the grid of RadFileExplorer.

To handle this event, simply write a JavaScript function that can be called when the event occurs. Then assign the name of this function as the value of the OnClientFilter property of the control.

The client-side OnClientFilter event handler receives two arguments:

Sender: The RadFileExplorer object that fired the event.

Event arguments: An event arguments object of type Telerik.Web.UI.RadFileExplorerFilterEventArgs that exposes the following methods:

Table 1: OnClientFilter Event Arguments Object

Name	Parameters	Return Type
get_cancel()	Boolean	Returns a value that indicates whether the event is cancelled.
get_domEvent()	Object	Returns а reference to the DOM event that triggered the filtering.
get_text()	String	Returns the filtering text.
set_cancel(value)	Boolean	Sets whether the event will be cancelled (if true is passed).
set_text(value)	Sets the filtering text.

Example 1: Handle the RadFileExplorer's client-side Filter event.

ASP.NET

<telerik:RadFileExplorer ID="RadFileExplorer1" runat="server"  OnClientFilter="onClientFilter" EnableFilterTextBox="true">
    <Configuration ViewPaths="~/Images" DeletePaths="~/Images" UploadPaths="~/Images" />
</telerik:RadFileExplorer>
<script>
    function onClientFilter(fileExplorer, args) {
        var filterText = args.get_text();
        if (filterText.length <= 3) {
            //cancel the event if the filter text contains less than three chars
            args.set_cancel(true);
        }
    }
</script>

OnClientFilter

See Also