New to Telerik UI for WinFormsStart a free 30-day trial

Base class for file and folder dialogs.

Definition

Namespace:Telerik.WinControls.FileDialogs

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class FileDialogFormBase : RadForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation, IInvokeSelectedFileSystemObjects

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormFileDialogFormBase...

Derived Classes: RadOpenFileDialogFormRadOpenFolderDialogFormRadSaveFileDialogForm

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIContainerControlIDisposableIDropTargetIInvokeSelectedFileSystemObjectsILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadForm.ScrollToControl(Control)RadForm.EndInit()RadForm.WndProc(ref Message)RadForm.ProcessCaptureChangeRequested(RadElement, bool)RadForm.InitializeFormBehavior()RadForm.SetIconPrimitiveVisibility(bool)RadForm.Dispose(bool)RadForm.EnableUIAutomationRadForm.TextRadForm.ThemeClassNameRadForm.FormElementRadForm.IconScalingRadForm.AllowThemingRadForm.ShowIconRadFormControlBase.newBoundsRadFormControlBase.oldDpiRadFormControlBase.currentDpiRadFormControlBase.isBehaviorPreparedRadFormControlBase.controlIsInitializingRootComponentRadFormControlBase.isPaintingRadFormControlBase.Construct()RadFormControlBase.OnCreateControl()RadFormControlBase.LoadElementTree()RadFormControlBase.LoadElementTree(Size)RadFormControlBase.OnLoad(Size)RadFormControlBase.OnShown(EventArgs)RadFormControlBase.OnPaint(PaintEventArgs)RadFormControlBase.OnPaintBackground(PaintEventArgs)RadFormControlBase.ProcessDialogKey(Keys)RadFormControlBase.UpdateDefaultButton()RadFormControlBase.OnBackColorChanged(EventArgs)RadFormControlBase.OnForeColorChanged(EventArgs)RadFormControlBase.OnFontChanged(EventArgs)RadFormControlBase.OnParentChanged(EventArgs)RadFormControlBase.ShouldSerializeProperty(RadProperty)RadFormControlBase.ResetFormBehavior(bool)RadFormControlBase.PerformDesignModeLocationCorrection(ref Message)RadFormControlBase.CallBaseWndProc(ref Message)RadFormControlBase.ProcessFocusRequested(RadElement)RadFormControlBase.OnNotifyPropertyChanged(string)RadFormControlBase.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadFormControlBase.CreateChildItems(RadElement)RadFormControlBase.CreateRootElement()RadFormControlBase.OnThemeNameChanged(ThemeNameChangedEventArgs)RadFormControlBase.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadFormControlBase.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadFormControlBase.OnHandleCreated(EventArgs)RadFormControlBase.OnVisibleChanged(EventArgs)RadFormControlBase.OnAutoSizeChanged(EventArgs)RadFormControlBase.OnLayout(LayoutEventArgs)RadFormControlBase.CreateHandle()RadFormControlBase.SetClientSizeCore(int, int)RadFormControlBase.SetBoundsCore(int, int, int, int, BoundsSpecified)RadFormControlBase.GetPreferredSize(Size)RadFormControlBase.InvalidateIfNotSuspended()RadFormControlBase.InvalidateElement(RadElement)RadFormControlBase.InvalidateElement(RadElement, Rectangle)RadFormControlBase.AddInvalidatedRect(Rectangle)RadFormControlBase.SuspendUpdate()RadFormControlBase.ResumeUpdate()RadFormControlBase.ResumeUpdate(bool)RadFormControlBase.RegisterHostedControl(RadHostItem)RadFormControlBase.UnregisterHostedControl(RadHostItem, bool)RadFormControlBase.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadFormControlBase.ControlThemeChangedCallback()RadFormControlBase.InvokeLayoutCallback(LayoutCallback)RadFormControlBase.BeginInit()RadFormControlBase.HandleDpiChanged()RadFormControlBase.ScaleControl(SizeF, BoundsSpecified)RadFormControlBase.SuspendDpiScaling()RadFormControlBase.ResumeDpiScaling()RadFormControlBase.OnWm_SettingChange(Message)RadFormControlBase.SiteRadFormControlBase.EnableAnalyticsRadFormControlBase.IsLoadedRadFormControlBase.MaximumSizeRadFormControlBase.MinimumSizeRadFormControlBase.FormBorderStyleRadFormControlBase.FormBehaviorRadFormControlBase.BehaviorRadFormControlBase.SmallImageListRadFormControlBase.FocusedElementRadFormControlBase.AllowShowFocusCuesRadFormControlBase.ShowItemToolTipsRadFormControlBase.CommandBindingsRadFormControlBase.EnableKeyMapRadFormControlBase.WindowsSettingsRadFormControlBase.BackColorRadFormControlBase.ForeColorRadFormControlBase.FontRadFormControlBase.CreateParamsRadFormControlBase.IsDesignModeRadFormControlBase.ElementTreeRadFormControlBase.ThemeNameRadFormControlBase.RootElementRadFormControlBase.IsUpdateSuspendedRadFormControlBase.ImageListRadFormControlBase.SmallImageScalingSizeRadFormControlBase.ImageScalingSizeRadFormControlBase.IsInitializedRadFormControlBase.IsPerformingScaleRadFormControlBase.HasOwnToolbarRadFormControlBase.IsDpiScalingSuspendedRadFormControlBase.ThemeNameChangedRadFormControlBase.ToolTipTextNeededRadFormControlBase.ScreenTipNeededRadFormControlBase.InitializedRadFormControlBase.PropertyChangedRadFormControlBase.WindowsThemeChangedForm.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.Close()Form.CreateControlsInstance()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnActivated(EventArgs)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnClosing(CancelEventArgs)Form.OnFormClosing(FormClosingEventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnHandleDestroyed(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessCmdKey(ref Message, Keys)Form.ProcessDialogChar(char)Form.ProcessKeyPreview(ref Message)Form.ProcessTabKey(bool)Form.RemoveOwnedForm(Form)Form.Select(bool, bool)Form.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Form.SetDesktopBounds(int, int, int, int)Form.SetDesktopLocation(int, int)Form.Show(IWin32Window)Form.ToString()Form.OnResizeBegin(EventArgs)Form.OnResizeEnd(EventArgs)Form.OnStyleChanged(EventArgs)Form.ValidateChildren()Form.ValidateChildren(ValidationConstraints)Form.AcceptButtonForm.ActiveFormForm.ActiveMdiChildForm.AllowTransparencyForm.AutoScrollForm.AutoSizeForm.AutoSizeModeForm.AutoValidateForm.CancelButtonForm.ClientSizeForm.ControlBoxForm.DefaultImeModeForm.DefaultSizeForm.DesktopBoundsForm.DesktopLocationForm.DialogResultForm.HelpButtonForm.IconForm.IsMdiChildForm.IsMdiContainerForm.IsRestrictedWindowForm.KeyPreviewForm.LocationForm.MaximizedBoundsForm.MainMenuStripForm.MenuForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEnd...

Properties

Gets or sets the collection of custom places.

C#
public IList<string> CustomPlaces { get; }
C#
public DialogViewModel DialogViewModel { get; }

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.

C#
public EditingOptions EditingOptions { get; set; }

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

C#
public bool ExpandToCurrentDirectory { get; set; }
C#
public virtual ExplorerControl ExplorerControl { get; }

Gets or sets a string containing the selected file name.

C#
public string FileName { get; set; }
C#
protected FileSystemInfoWrapperFactoryBase FileSystemInfoWrapperFactory { get; }

Gets or sets the initial directory.

C#
public string InitialDirectory { get; set; }

Gets or sets the initialLayoutType.

C#
public LayoutType InitialSelectedLayout { get; set; }

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

C#
public bool RestoreDirectory { get; set; }

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

C#
public bool ShowHiddenFiles { get; set; }

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

C#
public bool ShowNetworkLocations { get; set; }
C#
public IList<IViewModelChangedListener> ViewModelChangedListeners { get; set; }

Methods

C#
protected virtual bool CanPressedCancelExecute()
Returns:

bool

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

C#
protected virtual IList<DirectoryInfoWrapper> GetDialogViewModelCustomPlaces()
Returns:

IList<DirectoryInfoWrapper>

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.

C#
protected virtual DirectoryInfoWrapper GetDialogViewModelInitialDirectory()
Returns:

DirectoryInfoWrapper

C#
public virtual void InvokeSelectedFileSystemObjects()

Implements: IInvokeSelectedFileSystemObjects.InvokeSelectedFileSystemObjects()

C#
protected void NotifyIViewModelChangedListeners()
C#
protected override void OnClosed(EventArgs e)
Parameters:eEventArgs

Overrides: Form.OnClosed(EventArgs)

Called before the KeyDown event occurs.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

The data for the event.

Overrides: Control.OnKeyDown(KeyEventArgs)

Raises the Load event and applies any pending theming settings.

C#
protected override void OnLoad(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: RadForm.OnLoad(EventArgs)

C#
protected virtual void OnPressedCancel()

Called when the theme has changed.

C#
protected override void OnThemeChanged()

Overrides: RadFormControlBase.OnThemeChanged()

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

C#
protected virtual void SaveStateOnAccept()
C#
protected virtual void SetupDialogContent(bool addWatcher = true)
Parameters:addWatcherbool

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

C#
public DialogResult ShowDialog()
Returns:

DialogResult

The DialogResult value.

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

C#
public DialogResult ShowDialog(IWin32Window owner)
Parameters:ownerIWin32WindowReturns:

DialogResult

The DialogResult value.

Show for testing purposes.

C#
protected virtual DialogResult ShowDialogCore(IWin32Window owner = null, bool addWatcher = true)
Parameters:ownerIWin32WindowaddWatcherboolReturns:

DialogResult

Events

Occurs when the current folder is about to change.

C#
public event EventHandler<DirectoryNavigatingEventArgs> DirectoryNavigating

Occurs when the DirectoryInfo wrapper is about to be created.

C#
public event EventHandler<DirectoryRequestingEventArgs> DirectoryRequesting

Occurs when the Exception is raised.

C#
public event EventHandler<FileBrowserExceptionRaisedEventArgs> ExceptionRaised

Occurs when context menu is about to open.

C#
public event EventHandler<ContextMenuOpeningEventArgs> ShellContextMenuOpening