skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • AI Coding Assistants
    • Embedded Reporting
    • Document Processing Libraries
    • SSO Account Sign-in

    Web

    Kendo UI UI for Angular UI for Vue UI for jQuery KendoReact UI for Blazor UI for ASP.NET Core UI for ASP.NET MVC UI for ASP.NET AJAX

    Mobile

    UI for .NET MAUI

    Document Management

    Telerik Document Processing

    Desktop

    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF

    Reporting

    Telerik Reporting Telerik Report Server

    Testing & Mocking

    Test Studio Telerik JustMock

    CMS

    Sitefinity

    AI Productivity Tools

    AI Coding Assistants

    UI/UX Tools

    ThemeBuilder Design System Kit Templates and Building Blocks

    Debugging

    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Everywhere Reporter FiddlerCore

    Free Tools

    KendoReact Free VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Support and Learning

    • Support and Learning Hub
    • First Steps
    • Docs
    • Demos
    • Virtual Classroom
    • Forums
    • Videos
    • Blogs
    • Accessibility
    • Submit a Ticket

    Productivity and Design Tools

    • Visual Studio Extensions
    • Visual Studio Templates
    • Embedded Reporting
  • Pricing
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Downloads
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class FileDialogFormBase

Base class for file and folder dialogs.

Inheritance
System.Object
RadFormControlBase
RadForm
FileDialogFormBase
RadOpenFileDialogForm
RadOpenFolderDialogForm
RadSaveFileDialogForm
Inherited Members
RadForm.ScrollToControl(Control)
RadForm.EndInit()
RadForm.ProcessCaptureChangeRequested(RadElement, Boolean)
RadForm.InitializeFormBehavior()
RadForm.SetIconPrimitiveVisibility(Boolean)
RadForm.Dispose(Boolean)
RadForm.Text
RadForm.ThemeClassName
RadForm.FormElement
RadForm.IconScaling
RadForm.AllowTheming
RadForm.ShowIcon
RadFormControlBase.newBounds
RadFormControlBase.oldDpi
RadFormControlBase.currentDpi
RadFormControlBase.isBehaviorPrepared
RadFormControlBase.controlIsInitializingRootComponent
RadFormControlBase.isPainting
RadFormControlBase.Construct()
RadFormControlBase.GetUseNewLayout()
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.ShouldSerializeBackColor()
RadFormControlBase.OnBackColorChanged(EventArgs)
RadFormControlBase.ShouldSerializeForeColor()
RadFormControlBase.OnForeColorChanged(EventArgs)
RadFormControlBase.ShouldSerializeFont()
RadFormControlBase.OnFontChanged(EventArgs)
RadFormControlBase.OnParentChanged(EventArgs)
RadFormControlBase.ShouldSerializeProperty(RadProperty)
RadFormControlBase.ResetFormBehavior(Boolean)
RadFormControlBase.WndProc(Message)
RadFormControlBase.PerformDesignModeLocationCorrection(Message)
RadFormControlBase.CallBaseWndProc(Message)
RadFormControlBase.IComponentTreeHandler.GetAmbientPropertyValue(RadProperty)
RadFormControlBase.IComponentTreeHandler.OnAmbientPropertyChanged(RadProperty)
RadFormControlBase.IComponentTreeHandler.OnFocusRequested(RadElement)
RadFormControlBase.IComponentTreeHandler.OnCaptureChangeRequested(RadElement, Boolean)
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.IComponentTreeHandler.InitializeRootElement(RootRadElement)
RadFormControlBase.IComponentTreeHandler.CreateRootElement()
RadFormControlBase.IComponentTreeHandler.CreateChildItems(RadElement)
RadFormControlBase.IComponentTreeHandler.CallOnThemeNameChanged(ThemeNameChangedEventArgs)
RadFormControlBase.OnAutoSizeChanged(EventArgs)
RadFormControlBase.OnLayout(LayoutEventArgs)
RadFormControlBase.CreateHandle()
RadFormControlBase.SetClientSizeCore(Int32, Int32)
RadFormControlBase.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)
RadFormControlBase.GetPreferredSize(Size)
RadFormControlBase.InvalidateIfNotSuspended()
RadFormControlBase.IComponentTreeHandler.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)
RadFormControlBase.IComponentTreeHandler.CallOnMouseCaptureChanged(EventArgs)
RadFormControlBase.IComponentTreeHandler.CallOnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadFormControlBase.InvalidateElement(RadElement)
RadFormControlBase.InvalidateElement(RadElement, Rectangle)
RadFormControlBase.AddInvalidatedRect(Rectangle)
RadFormControlBase.SuspendUpdate()
RadFormControlBase.ResumeUpdate()
RadFormControlBase.ResumeUpdate(Boolean)
RadFormControlBase.RegisterHostedControl(RadHostItem)
RadFormControlBase.UnregisterHostedControl(RadHostItem, Boolean)
RadFormControlBase.ControlDefinesThemeForElement(RadElement)
RadFormControlBase.OnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadFormControlBase.IComponentTreeHandler.CallOnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadFormControlBase.ControlThemeChangedCallback()
RadFormControlBase.IComponentTreeHandler.GetShowFocusCues()
RadFormControlBase.InvokeLayoutCallback(LayoutCallback)
RadFormControlBase.BeginInit()
RadFormControlBase.HandleDpiChanged()
RadFormControlBase.ScaleControl(SizeF, BoundsSpecified)
RadFormControlBase.SuspendDpiScaling()
RadFormControlBase.ResumeDpiScaling()
RadFormControlBase.OnWm_SettingChange(Message)
RadFormControlBase.IComponentTreeHandler.get_Name()
RadFormControlBase.IComponentTreeHandler.set_Name(String)
RadFormControlBase.Site
RadFormControlBase.AnalyticsName
RadFormControlBase.EnableAnalytics
RadFormControlBase.IsLoaded
RadFormControlBase.MaximumSize
RadFormControlBase.MinimumSize
RadFormControlBase.FormBorderStyle
RadFormControlBase.FormBehavior
RadFormControlBase.Behavior
RadFormControlBase.SmallImageList
RadFormControlBase.FocusedElement
RadFormControlBase.AllowShowFocusCues
RadFormControlBase.ShowItemToolTips
RadFormControlBase.CommandBindings
RadFormControlBase.EnableKeyMap
RadFormControlBase.WindowsSettings
RadFormControlBase.BackColor
RadFormControlBase.ForeColor
RadFormControlBase.Font
RadFormControlBase.CreateParams
RadFormControlBase.IsDesignMode
RadFormControlBase.ElementTree
RadFormControlBase.IComponentTreeHandler.Behavior
RadFormControlBase.IComponentTreeHandler.ThemeClassName
RadFormControlBase.ThemeName
RadFormControlBase.RootElement
RadFormControlBase.IsUpdateSuspended
RadFormControlBase.IComponentTreeHandler.SmallImageList
RadFormControlBase.ImageList
RadFormControlBase.SmallImageScalingSize
RadFormControlBase.ImageScalingSize
RadFormControlBase.IComponentTreeHandler.Initializing
RadFormControlBase.LayoutManager
RadFormControlBase.IsInitialized
RadFormControlBase.IsPerformingScale
RadFormControlBase.HasOwnToolbar
RadFormControlBase.IsDpiScalingSuspended
RadFormControlBase.ThemeNameChanged
RadFormControlBase.ToolTipTextNeeded
RadFormControlBase.ScreenTipNeeded
RadFormControlBase.Initialized
RadFormControlBase.PropertyChanged
RadFormControlBase.WindowsThemeChanged
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
IInvokeSelectedFileSystemObjects.InvokeSelectedFileSystemObjects()

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
RadForm.OnLoad(EventArgs)

OnPressedCancel()

Declaration
protected virtual void OnPressedCancel()

OnThemeChanged()

Declaration
protected override void OnThemeChanged()
Overrides
RadFormControlBase.OnThemeChanged()

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

SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)
Getting Started
  • Install Now
  • Demos
  • Step-by-Step Tutorial
  • Sample Applications
  • SDK Samples
  • Visual Studio Extensions
Support Resources
  • Code Library
  • Knowledge Base
  • Videos
Community
  • Forums
  • Blogs
  • Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.