XtraOpenFileDialog Members
A replacement for the standard WinForms OpenFileDialog. Supports theming by DevExpress Skins.Constructors
| Name | Description |
|---|---|
| XtraOpenFileDialog() | Initializes a new instance of the XtraOpenFileDialog class with the default settings. |
| XtraOpenFileDialog(IContainer) | Initializes a new instance of the XtraOpenFileDialog class with the specified settings. |
Properties
| Name | Description |
|---|---|
| AddExtension | Gets or sets whether a dialog should automatically add an extension to a file name if a user omits the extension. This property is identical to the standard FileDialog.AddExtension property. Inherited from FileDialogBase. |
| AutoUpdateFilterDescription | Gets or sets whether a dialog with file extension filters (see FileDialogBase.Filter) shows filter patterns for each filter option. Inherited from FileDialogBase. |
| CanRaiseEvents protected | Gets a value indicating whether the component can raise an event. Inherited from Component. |
| CheckFileExists | Gets or sets whether or not this XtraOpenFileDialog should warn a user if a file with the specified name does not exist. |
| CheckPathExists | Gets or sets whether the dialog box displays a warning if a user specifies a path that does not exist. This property is identical to the standard FileDialog.CheckPathExists property. Inherited from FileDialogBase. |
| Container | Gets the IContainer that contains the Component. Inherited from Component. |
| CustomPlaces | A collection of quick access paths to which a user can navigate. This property is identical to the standard FileDialog.CustomPlaces property. Inherited from FileDialogBase. |
| DefaultExt | Gets or sets the default file extension (without the dot character). This property is identical to the standard FileDialog.DefaultExt property. Inherited from FileDialogBase. |
| DefaultViewMode | Gets or sets the initial dialog view (“Tiles”, “Table”, “Medium icons”, etc.). Inherited from FileDialogBase. |
| DereferenceLinks | If a user selects a shortcut, this property specifies whether the dialog returns this shortcut location, or the location of a file this shortcut references. This property is identical to the standard FileDialog.DereferenceLinks property. Inherited from FileDialogBase. |
| DesignMode protected | Gets a value that indicates whether the Component is currently in design mode. Inherited from Component. |
| Events protected | Gets the list of event handlers that are attached to this Component. Inherited from Component. |
| FileName | Gets or sets the selected file name, or an empty string if no file was selected. This property is identical to the standard FileDialog.FileName property. Inherited from FileDialogBase. |
| FileNames | Returns an array of file names opened in the XtraOpenFileDialog. Has no effect for the XtraSaveFileDialog. This property is identical to the standard FileDialog.FileNames property. Inherited from FileDialogBase. |
| Filter | Allows you to save or open files only of specific types. This property is identical to the standard FileDialog.Filter property. Inherited from FileDialogBase. |
| FilterIndex | Gets or sets the index of the filter currently selected in the file dialog box. This property is identical to the standard FileDialog.FilterIndex property. Inherited from FileDialogBase. |
| InitialDirectory | Gets or sets the location which the dialog shows upon the first launch. This property is identical to the standard FileDialog.InitialDirectory. Inherited from FileDialogBase. |
| Multiselect | Gets or sets whether or not users are allowed to select multiple files in this XtraOpenFileDialog. |
| RestoreDirectory | If a user navigates to a different directory and closes the dialog without saving (opening) a new file, this property specifies whether this new location should be remembered. This property is identical to the standard FileDialog.RestoreDirectory property. Inherited from FileDialogBase. |
| SafeFileName | Returns the selected file name and extension. The returned name does not include the file path. |
| SafeFileNames | Returns an array of file names and extensions for all the selected files in the dialog box. File names do not include paths. |
| ShowHelp | Gets or sets whether the dialog displays the Help button. This property is identical to the standard FileDialog.ShowHelp property. Inherited from FileDialogBase. |
| Site | Gets or sets the ISite of the Component. Inherited from Component. |
| SupportMultiDottedExtensions | Gets or sets whether the dialog supports filters with more than one dot character. This property is identical to the standard FileDialog.SupportMultiDottedExtensions property. Inherited from FileDialogBase. |
| Tag | Gets or sets an object that contains data about the control. Inherited from CommonDialog. |
| ValidateNames | Gets or sets whether the dialog supports Win32 file names only (no angle brackets, no colons, 3-character extension, etc.). This property is identical to the standard FileDialog.ValidateNames property. Inherited from FileDialogBase. |
Methods
| Name | Description |
|---|---|
| CreateObjRef(Type) | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. Inherited from MarshalByRefObject. |
| Dispose() | Releases all resources used by the Component. Inherited from Component. |
| Equals(Object, Object) static | Determines whether the specified object instances are considered equal. Inherited from Object. |
| Equals(Object) | Determines whether the specified object is equal to the current object. Inherited from Object. |
| GetHashCode() | Serves as the default hash function. Inherited from Object. |
| GetLifetimeService() | Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject. |
| GetService(Type) protected | Returns an object that represents a service provided by the Component or by its Container. Inherited from Component. |
| GetType() | Gets the Type of the current instance. Inherited from Object. |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) protected | Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box. Inherited from CommonDialog. |
| InitializeLifetimeService() | Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject. |
| MemberwiseClone() protected | Creates a shallow copy of the current Object. Inherited from Object. |
| MemberwiseClone(Boolean) protected | Creates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject. |
| OnHelpRequest(EventArgs) protected | Raises the HelpRequest event. Inherited from CommonDialog. |
| OpenFile() | Opens the file specified by the FileName property. The file is opened with read-only permission. |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) protected | Defines the owner window procedure that is overridden to add specific functionality to a common dialog box. Inherited from CommonDialog. |
| ReferenceEquals(Object, Object) static | Determines whether the specified Object instances are the same instance. Inherited from Object. |
| Reset() | Resets all dialog properties to their default values. Inherited from FileDialogBase. |
| ShowDialog() | Runs a common dialog box with a default owner. Inherited from CommonDialog. |
| ShowDialog(IWin32Window) | Runs a common dialog box with the specified owner. Inherited from CommonDialog. |
| ToString() | Returns a String containing the name of the Component, if any. This method should not be overridden. Inherited from Component. |
Events
| Name | Description |
|---|---|
| Disposed | Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component. |
| FileOk | Fires when a user presses “Save” or “Open” (depending on the current dialog type). Inherited from FileDialogBase. |
| HelpRequest | Occurs when the user clicks the Help button on a common dialog box. Inherited from CommonDialog. |
See Also