Class
ExplorerControl

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

Definition

Namespace:Telerik.Windows.Controls.FileDialogs

Assembly:Telerik.Windows.Controls.FileDialogs.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("File Dialogs")]
public sealed class ExplorerControl : Control

Inheritance: objectExplorerControl

Constructors

ExplorerControl()

Initializes a new instance of the ExplorerControl class.

Declaration

cs-api-definition
public ExplorerControl()

Fields

CanUserRenameProperty

Identifies the CanUserRename dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanUserRenameProperty

Field Value

DependencyProperty

CurrentDirectoryPathProperty

Identifies the CurrentDirectoryPath dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CurrentDirectoryPathProperty

Field Value

DependencyProperty

CustomPlacesPathsProperty

Identifies the CustomPlacesPaths dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CustomPlacesPathsProperty

Field Value

DependencyProperty

DragDropBehaviorProperty

Identifies the DragDropBehavior dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DragDropBehaviorProperty

Field Value

DependencyProperty

ExpandToCurrentDirectoryProperty

Identifies the ExpandToCurrentDirectory dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ExpandToCurrentDirectoryProperty

Field Value

DependencyProperty

FilterDescriptorsProperty

Identifies the FilterDescriptors dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FilterDescriptorsProperty

Field Value

DependencyProperty

FilterIndexProperty

Identifies the FilterIndex dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FilterIndexProperty

Field Value

DependencyProperty

FilterProperty

Identifies the Filter dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FilterProperty

Field Value

DependencyProperty

IsDragDropEnabledProperty

Identifies the IsDragDropEnabled dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsDragDropEnabledProperty

Field Value

DependencyProperty

IsFolderBrowserProperty

Identifies the IsFolderBrowser dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsFolderBrowserProperty

Field Value

DependencyProperty

LayoutProperty

Identifies the Layout dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty LayoutProperty

Field Value

DependencyProperty

LoadDrivesInBackgroundProperty

Identifies the LoadDrivesInBackground dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty LoadDrivesInBackgroundProperty

Field Value

DependencyProperty

MultiselectProperty

Identifies the Multiselect dependency property.

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Multiselect")]
public static readonly DependencyProperty MultiselectProperty

Field Value

DependencyProperty

SelectedFileNameProperty

Identifies the SelectedFileName dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedFileNameProperty

Field Value

DependencyProperty

SelectedFileNamesProperty

Identifies the SelectedFileNames dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedFileNamesProperty

Field Value

DependencyProperty

SelectedSafeFileNamesProperty

Identifies the SelectedSafeFileNames dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedSafeFileNamesProperty

Field Value

DependencyProperty

ShowHiddenFilesProperty

Identifies the ShowHiddenFiles dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowHiddenFilesProperty

Field Value

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

cs-api-definition
public bool CanUserRename { get; set; }

Property Value

bool

CurrentDirectoryPath

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

Declaration

cs-api-definition
public string CurrentDirectoryPath { get; set; }

Property Value

string

CustomPlacesPaths

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

Declaration

cs-api-definition
public IEnumerable<string> CustomPlacesPaths { get; set; }

Property Value

IEnumerable<string>

DragDropBehavior

Gets or sets the FileBrowserDragDropBehavior for this ExplorerControl.

Declaration

cs-api-definition
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

cs-api-definition
public bool ExpandToCurrentDirectory { get; set; }

Property Value

bool

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

cs-api-definition
public string Filter { get; set; }

Property Value

string

FilterDescriptors

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

Declaration

cs-api-definition
public IList<FileFilterDescriptor> FilterDescriptors { get; }

Property Value

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

cs-api-definition
public int FilterIndex { get; set; }

Property Value

int

IsDragDropEnabled

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

Declaration

cs-api-definition
public bool IsDragDropEnabled { get; set; }

Property Value

bool

IsFolderBrowser

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

Declaration

cs-api-definition
public bool IsFolderBrowser { get; set; }

Property Value

bool

Layout

Gets or sets the current LayoutType of the Main pane.

Declaration

cs-api-definition
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

cs-api-definition
public bool LoadDrivesInBackground { get; set; }

Property Value

bool

Multiselect

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

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Multiselect")]
public bool Multiselect { get; set; }

Property Value

bool

SelectedFileName

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

Declaration

cs-api-definition
public string SelectedFileName { get; }

Property Value

string

SelectedFileNames

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

Declaration

cs-api-definition
public IList<string> SelectedFileNames { get; }

Property Value

IList<string>

SelectedSafeFileNames

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

Declaration

cs-api-definition
public IList<string> SelectedSafeFileNames { get; }

Property Value

IList<string>

ShowHiddenFiles

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

Declaration

cs-api-definition
public bool ShowHiddenFiles { get; set; }

Property Value

bool

ShowNetworkLocations

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

Declaration

cs-api-definition
public bool ShowNetworkLocations { get; set; }

Property Value

bool

Methods

OnApplyTemplate()

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnInitialized(EventArgs)

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

OnKeyDown(KeyEventArgs)

Declaration

cs-api-definition
protected override void OnKeyDown(KeyEventArgs e)

Parameters

e

KeyEventArgs

ResetTheme()

Declaration

cs-api-definition
public void ResetTheme()

Events

DirectoryNavigating

Occurs when the current folder is about to change.

Declaration

cs-api-definition
public event EventHandler<DirectoryNavigatingEventArgs> DirectoryNavigating

Event Value

EventHandler<DirectoryNavigatingEventArgs>

DirectoryRequesting

Occurs when the DirectoryInfo wrapper is about to be created.

Declaration

cs-api-definition
public event EventHandler<DirectoryRequestingEventArgs> DirectoryRequesting

Event Value

EventHandler<DirectoryRequestingEventArgs>

ExceptionRaised

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

Declaration

cs-api-definition
public event EventHandler<FileBrowserExceptionRaisedEventArgs> ExceptionRaised

Event Value

EventHandler<FileBrowserExceptionRaisedEventArgs>

Renaming

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

Declaration

cs-api-definition
public event EventHandler<RenamingEventArgs> Renaming

Event Value

EventHandler<RenamingEventArgs>

ShellContextMenuOpening

Occurs when context menu is about to open.

Declaration

cs-api-definition
public event EventHandler<ContextMenuOpeningEventArgs> ShellContextMenuOpening

Event Value

EventHandler<ContextMenuOpeningEventArgs>