Class ExplorerControl

Control used for the navigation part of the RadOpenFileDialog, RadSaveFileDialog and RadOpenFolderDialog

Inheritance
System.Object
ExplorerControl
Namespace: Telerik.Windows.Controls.FileDialogs
Assembly: Telerik.Windows.Controls.FileDialogs.dll

Syntax

[TelerikToolboxCategory("File Dialogs")]
public sealed class ExplorerControl : Control, IThemable

Constructors

ExplorerControl()

Initializes a new instance of the ExplorerControl class.

Declaration
public ExplorerControl()

Fields

CanUserRenameProperty

Identifies the CanUserRename dependency property.

Declaration
public static readonly DependencyProperty CanUserRenameProperty
Field Value
System.Windows.DependencyProperty

CurrentDirectoryPathProperty

Identifies the CurrentDirectoryPath dependency property.

Declaration
public static readonly DependencyProperty CurrentDirectoryPathProperty
Field Value
System.Windows.DependencyProperty

CustomPlacesPathsProperty

Identifies the CustomPlacesPaths dependency property.

Declaration
public static readonly DependencyProperty CustomPlacesPathsProperty
Field Value
System.Windows.DependencyProperty

DragDropBehaviorProperty

Identifies the DragDropBehavior dependency property.

Declaration
public static readonly DependencyProperty DragDropBehaviorProperty
Field Value
System.Windows.DependencyProperty

ExpandToCurrentDirectoryProperty

Identifies the ExpandToCurrentDirectory dependency property.

Declaration
public static readonly DependencyProperty ExpandToCurrentDirectoryProperty
Field Value
System.Windows.DependencyProperty

FilterDescriptorsProperty

Identifies the FilterDescriptors dependency property.

Declaration
public static readonly DependencyProperty FilterDescriptorsProperty
Field Value
System.Windows.DependencyProperty

FilterIndexProperty

Identifies the FilterIndex dependency property.

Declaration
public static readonly DependencyProperty FilterIndexProperty
Field Value
System.Windows.DependencyProperty

FilterProperty

Identifies the Filter dependency property.

Declaration
public static readonly DependencyProperty FilterProperty
Field Value
System.Windows.DependencyProperty

IsDragDropEnabledProperty

Identifies the IsDragDropEnabled dependency property.

Declaration
public static readonly DependencyProperty IsDragDropEnabledProperty
Field Value
System.Windows.DependencyProperty

IsFolderBrowserProperty

Identifies the IsFolderBrowser dependency property.

Declaration
public static readonly DependencyProperty IsFolderBrowserProperty
Field Value
System.Windows.DependencyProperty

LayoutProperty

Identifies the Layout dependency property.

Declaration
public static readonly DependencyProperty LayoutProperty
Field Value
System.Windows.DependencyProperty

LoadDrivesInBackgroundProperty

Identifies the LoadDrivesInBackground dependency property.

Declaration
public static readonly DependencyProperty LoadDrivesInBackgroundProperty
Field Value
System.Windows.DependencyProperty

MultiselectProperty

Identifies the Multiselect dependency property.

Declaration
public static readonly DependencyProperty MultiselectProperty
Field Value
System.Windows.DependencyProperty

SelectedFileNameProperty

Identifies the SelectedFileName dependency property.

Declaration
public static readonly DependencyProperty SelectedFileNameProperty
Field Value
System.Windows.DependencyProperty

SelectedFileNamesProperty

Identifies the SelectedFileNames dependency property.

Declaration
public static readonly DependencyProperty SelectedFileNamesProperty
Field Value
System.Windows.DependencyProperty

SelectedSafeFileNamesProperty

Identifies the SelectedSafeFileNames dependency property.

Declaration
public static readonly DependencyProperty SelectedSafeFileNamesProperty
Field Value
System.Windows.DependencyProperty

ShowHiddenFilesProperty

Identifies the ShowHiddenFiles dependency property.

Declaration
public static readonly DependencyProperty ShowHiddenFilesProperty
Field Value
System.Windows.DependencyProperty

Properties

CanUserRename

Gets or sets a value indicating whether the user can rename file or folders via mouse click or keyboard F2 press in main pane.

Declaration
public bool CanUserRename { get; set; }
Property Value
System.Boolean

CurrentDirectoryPath

Gets or sets a value indicating the path of the current directory in this ExplorerControl instance.

Declaration
public string CurrentDirectoryPath { get; set; }
Property Value
System.String

CustomPlacesPaths

Gets or sets the paths to the custom places navigation tree view.

Declaration
public IEnumerable<string> CustomPlacesPaths { get; set; }
Property Value
System.Collections.Generic.IEnumerable<System.String>

DragDropBehavior

Gets or sets the FileBrowserDragDropBehavior for this ExplorerControl.

Declaration
public FileBrowserDragDropBehavior DragDropBehavior { get; set; }
Property Value
FileBrowserDragDropBehavior

ExpandToCurrentDirectory

Gets or sets a value indicating whether the main navigation pane expands and brings into view the current directory.

Declaration
public bool ExpandToCurrentDirectory { get; set; }
Property Value
System.Boolean

Filter

Gets or sets the filter string that describes the list of extensions to filter by. It has effect only when IsFolderBrowser is False.

Declaration
public string Filter { get; set; }
Property Value
System.String

FilterDescriptors

Gets the list of the FileFilterDescriptor specified by the Filter property. It has effect only when IsFolderBrowser is False.

Declaration
public IList<FileFilterDescriptor> FilterDescriptors { get; }
Property Value
System.Collections.Generic.IList<FileFilterDescriptor>

FilterIndex

Gets or sets a value indicating the current filter index from the list of filter strings specified by the Filter property. It has effect only when IsFolderBrowser is False.

Declaration
public int FilterIndex { get; set; }
Property Value
System.Int32

IsDragDropEnabled

Gets or sets a value indicating whether this ExplorerControl allows drag-drop operations.

Declaration
public bool IsDragDropEnabled { get; set; }
Property Value
System.Boolean

IsFolderBrowser

Gets or sets a value indicating whether this ExplorerControl instance is used for directories selection or both directories and files.

Declaration
public bool IsFolderBrowser { get; set; }
Property Value
System.Boolean

Layout

Gets or sets the current LayoutType of the Main pane.

Declaration
public LayoutType Layout { get; set; }
Property Value
LayoutType

LoadDrivesInBackground

Gets or sets a value indicating whether the control loads the drives under 'This PC ' node in background thread. Could be used in scenarios when some drives are expected to load slower than normal.

Declaration
public bool LoadDrivesInBackground { get; set; }
Property Value
System.Boolean

Multiselect

Gets or sets a value indicating whether multiple selection of files or folders is allowed.

Declaration
public bool Multiselect { get; set; }
Property Value
System.Boolean

SelectedFileName

Gets the full path of the currently selected file or directory.

Declaration
public string SelectedFileName { get; }
Property Value
System.String

SelectedFileNames

Gets the list of full paths of the currently selected files and / or folders.

Declaration
public IList<string> SelectedFileNames { get; }
Property Value
System.Collections.Generic.IList<System.String>

SelectedSafeFileNames

Gets the list of names of the currently selected files and / or folders.

Declaration
public IList<string> SelectedSafeFileNames { get; }
Property Value
System.Collections.Generic.IList<System.String>

ShowHiddenFiles

Gets or sets a boolean value indicating whether hidden files and folders should be visible in the Explorer.

Declaration
public bool ShowHiddenFiles { get; set; }
Property Value
System.Boolean

ShowNetworkLocations

Gets or sets a value indicating whether the dialog shows network computers in the navigation tree.

Declaration
public bool ShowNetworkLocations { get; set; }
Property Value
System.Boolean

Methods

OnApplyTemplate()

Declaration
public override void OnApplyTemplate()

OnInitialized(EventArgs)

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
System.EventArgs e

OnKeyDown(KeyEventArgs)

Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Input.KeyEventArgs e

ResetTheme()

Declaration
public void ResetTheme()

Events

DirectoryNavigating

Occurs when the current folder is about to change.

Declaration
public event EventHandler<DirectoryNavigatingEventArgs> DirectoryNavigating
Event Type
System.EventHandler<DirectoryNavigatingEventArgs>

DirectoryRequesting

Occurs when the DirectoryInfo wrapper is about to be created.

Declaration
public event EventHandler<DirectoryRequestingEventArgs> DirectoryRequesting
Event Type
System.EventHandler<DirectoryRequestingEventArgs>

ExceptionRaised

Occurs when Exception during File (or Directory) creation / observation / modification is raised.

Declaration
public event EventHandler<FileBrowserExceptionRaisedEventArgs> ExceptionRaised
Event Type
System.EventHandler<FileBrowserExceptionRaisedEventArgs>

Renaming

Occurs when a file or directory is about to enter edit mode.

Declaration
public event EventHandler<RenamingEventArgs> Renaming
Event Type
System.EventHandler<RenamingEventArgs>

ShellContextMenuOpening

Occurs when context menu is about to open.

Declaration
public event EventHandler<ContextMenuOpeningEventArgs> ShellContextMenuOpening
Event Type
System.EventHandler<ContextMenuOpeningEventArgs>

Extension Methods