Click or drag to resize

VistaFileDialog Class

Displays a dialog box from which the user can select a file.
Inheritance Hierarchy

Namespace:  Ookii.Dialogs.Wpf
Assembly:  Ookii.Dialogs.Wpf (in Ookii.Dialogs.Wpf.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
public abstract class VistaFileDialog

The VistaFileDialog type exposes the following members.

Constructors
  NameDescription
Protected methodVistaFileDialog
Creates a new instance of VistaFileDialog class.
Top
Properties
  NameDescription
Public propertyAddExtension
Gets or sets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.
Public propertyCheckFileExists
Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.
Public propertyCheckPathExists
Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.
Public propertyDefaultExt
Gets or sets the default file name extension.
Public propertyDereferenceLinks
Gets or sets a value indicating whether the dialog box returns the location of the file referenced by the shortcut or whether it returns the location of the shortcut (.lnk).
Protected propertyDownlevelDialog
Gets or sets the downlevel file dialog which is to be used if the Vista-style dialog is not supported.
Public propertyFileName
Gets or sets a string containing the file name selected in the file dialog box.
Public propertyFileNames
Gets the file names of all selected files in the dialog box.
Public propertyFilter
Gets or sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.
Public propertyFilterIndex
Gets or sets the index of the filter currently selected in the file dialog box.
Public propertyInitialDirectory
Gets or sets the initial directory displayed by the file dialog box.
Public propertyStatic memberIsVistaFileDialogSupported
Gets a value that indicates whether the current OS supports Vista-style common file dialogs.
Public propertyRestoreDirectory
Gets or sets a value indicating whether the dialog box restores the current directory before closing.
Public propertyTitle
Gets or sets the file dialog box title.
Public propertyValidateNames
Gets or sets a value indicating whether the dialog box accepts only valid Win32 file names.
Top
Methods
  NameDescription
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodOnFileOk
Raises the FileOk event.
Public methodReset
Resets all properties to their default values.
Public methodShowDialog
Displays the file dialog.
Public methodShowDialog(Window)
Displays the file dialog.
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Events
  NameDescription
Public eventFileOk
Event raised when the user clicks on the Open or Save button on a file dialog box.
Top
Remarks

Windows Vista provides a new style of common file dialog, with several new features (both from the user's and the programmers perspective).

This class and derived classes will use the Vista-style file dialogs if possible, and automatically fall back to the old-style dialog on versions of Windows older than Vista. This class is aimed at applications that target both Windows Vista and older versions of Windows, and therefore does not provide any of the new APIs provided by Vista's file dialogs.

This class precisely duplicates the public interface of FileDialog so you can just replace any instances of FileDialog with the VistaFileDialog without any further changes to your code.

Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also