Documentation

Class FileDialogFormBase

Base class for file and folder dialogs.

Inheritance
System.Object
RadFormControlBase
RadForm
FileDialogFormBase
RadOpenFileDialogForm
RadOpenFolderDialogForm
RadSaveFileDialogForm
Inherited Members
Namespace: Telerik.WinControls.FileDialogs
Assembly: Telerik.WinControls.UI.dll

Syntax

public class FileDialogFormBase : RadForm, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, IInvokeSelectedFileSystemObjects

Properties

CustomPlaces

Gets or sets the collection of custom places.

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

DialogViewModel

Declaration
public DialogViewModel DialogViewModel { get; }
Property Value
DialogViewModel

EditingOptions

Determines how the files and folders in the ExplorerControl can be edited. Note that the shell context menu and drag and drop operations are handled separately.

Declaration
public EditingOptions EditingOptions { get; set; }
Property Value
EditingOptions

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

ExplorerControl

Declaration
public virtual ExplorerControl ExplorerControl { get; }
Property Value
ExplorerControl

FileName

Gets or sets a string containing the selected file name.

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

FileSystemInfoWrapperFactory

Gets theFileSystemInfoWrapperFactoryBase for this FileDialogFormBase.

Declaration
protected FileSystemInfoWrapperFactoryBase FileSystemInfoWrapperFactory { get; }
Property Value
FileSystemInfoWrapperFactoryBase

InitialDirectory

Gets or sets the initial directory.

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

InitialSelectedLayout

Gets or sets the initialLayoutType.

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

RestoreDirectory

Gets or sets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.

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

ShowHiddenFiles

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

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

ViewModelChangedListeners

Declaration
public IList<IViewModelChangedListener> ViewModelChangedListeners { get; set; }
Property Value
System.Collections.Generic.IList<IViewModelChangedListener>

Methods

CanPressedCancelExecute()

Declaration
protected virtual bool CanPressedCancelExecute()
Returns
System.Boolean

GetDialogViewModelCustomPlaces()

Provides the CustomPlaces as list of DirectoryInfoWrappers to the DialogViewModel of this FileDialogFormBase instance.

Declaration
protected virtual IList<DirectoryInfoWrapper> GetDialogViewModelCustomPlaces()
Returns
System.Collections.Generic.IList<DirectoryInfoWrapper>

GetDialogViewModelInitialDirectory()

Provides the InitialDirectory as DirectoryInfoWrapper to the DialogViewModel of this FileDialogFormBase instance. Returns null if DirectoryInfo cannot be created due to incorrect InitialDirectory string or access rights.

Declaration
protected virtual DirectoryInfoWrapper GetDialogViewModelInitialDirectory()
Returns
DirectoryInfoWrapper

InvokeSelectedFileSystemObjects()

Declaration
public virtual void InvokeSelectedFileSystemObjects()
Implements

NotifyIViewModelChangedListeners()

Declaration
protected void NotifyIViewModelChangedListeners()

OnClosed(EventArgs)

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

OnKeyDown(KeyEventArgs)

Called before the System.Windows.UIElement.KeyDown event occurs.

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

The data for the event.

OnLoad(EventArgs)

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

Overrides

OnPressedCancel()

Declaration
protected virtual void OnPressedCancel()

OnThemeChanged()

Declaration
protected override void OnThemeChanged()
Overrides

SaveStateOnAccept()

Save information from the OpenFileDialogViewModel into this FileDialogFormBase instance before the window is closed on Accept.

Declaration
protected virtual void SaveStateOnAccept()

SetupDialogContent(Boolean)

Declaration
protected virtual void SetupDialogContent(bool addWatcher = true)
Parameters
System.Boolean addWatcher

ShowDialog()

Opens modal Dialog in case it hasn't been already opened.

Declaration
public DialogResult ShowDialog()
Returns
System.Windows.Forms.DialogResult

The DialogResult value.

ShowDialog(IWin32Window)

Opens modal Dialog in case it hasn't been already opened.

Declaration
public DialogResult ShowDialog(IWin32Window owner)
Parameters
System.Windows.Forms.IWin32Window owner

Returns
System.Windows.Forms.DialogResult

The DialogResult value.

ShowDialogCore(IWin32Window, Boolean)

Show for testing purposes.

Declaration
protected virtual DialogResult ShowDialogCore(IWin32Window owner = null, bool addWatcher = true)
Parameters
System.Windows.Forms.IWin32Window owner

System.Boolean addWatcher

Returns
System.Windows.Forms.DialogResult

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 the System.Exception is raised.

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

ShellContextMenuOpening

Occurs when context menu is about to open.

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

Extension Methods