Skip to main content

TdxSaveFileDialog Class

A Save As dialog component.

Declaration

TdxSaveFileDialog = class(
    TSaveDialog,
    IdxSkinSupport
)

Remarks

The TdxSaveFileDialog class implements a non-visual component that displays a Save As dialog that allows users to select and save files in the file system. The TdxSaveFileDialog component is compatible with the standard TSaveDialog component but has additional APIs for file preview customization as well as look & feel settings common to all DevExpress VCL controls. These settings allow you to apply the same skin to all UI elements and maintain appearance consistency for all application components, including shell dialogs.

VCL Editors Library: Different Skin Examples

The Save As dialog can display a preview of the selected file at the right border. You can use the OptionsPreview property to customize preview settings.

Invoke the Save As Dialog

You can call the component’s Execute procedure to invoke the Save As dialog. This dialog allows a user to select and save files. When a user clicks the Save button, the dialog saves the path to the selected file name to the FileName property and closes.

Main API Members

The list below outlines key members of the TdxSaveFileDialog class that allow you to configure the Save As file dialog and invoke it.

Execute
Invokes the Save As file dialog.
FileName
Returns the full path to the last file selected in the Save As file dialog when a user clicks the Save button to close the dialog. The dialog can display a preview of the last selected file.
Filter | FilterIndex
Specify filter masks for files.
ForceFileSystem
Specifies if only actual files and folders in the file system can be dialog targets. This option is useful if you need to prevent the dialog from returning an incorrect path.
InitialDir
Specifies the initially displayed directory.
LookAndFeel
Provides access to dialog look & feel settings.
Options | OptionsEx
Allow you to configure general dialog settings.
OptionsPreview
Provides access to file preview settings.

Skinnable Shell Dialogs in DevExpress Components

All DevExpress components with built-in Windows shell navigation functionality (such as Spreadsheet and Rich Edit controls) use skinnable dialogs instead of standard system dialogs. You can change the dxUseStandardShellDialogs global constant value to True if you prefer standard system dialogs.

Create a Custom Save As File Dialog

Inherit a class from TdxfrmSaveFileDialog to create a custom Save As dialog form. Assign a reference to the created class to the SaveFileDialogFormClass global variable to replace the built-in Save As dialog form with a custom implementation.

Implements

See Also