Vcl.Dialogs.TFileDialogOption
Delphi
TFileDialogOption = (fdoOverWritePrompt, fdoStrictFileTypes,
fdoNoChangeDir, fdoPickFolders, fdoForceFileSystem,
fdoAllNonStorageItems, fdoNoValidate, fdoAllowMultiSelect,
fdoPathMustExist, fdoFileMustExist, fdoCreatePrompt,
fdoShareAware, fdoNoReadOnlyReturn, fdoNoTestFileCreate,
fdoHideMRUPlaces, fdoHidePinnedPlaces, fdoNoDereferenceLinks,
fdoDontAddToRecent, fdoForceShowHidden, fdoDefaultNoMiniMode,
fdoForcePreviewPaneOn);
C++
enum DECLSPEC_DENUM TFileDialogOption : unsigned char { fdoOverWritePrompt, fdoStrictFileTypes, fdoNoChangeDir, fdoPickFolders, fdoForceFileSystem, fdoAllNonStorageItems, fdoNoValidate, fdoAllowMultiSelect, fdoPathMustExist, fdoFileMustExist, fdoCreatePrompt, fdoShareAware, fdoNoReadOnlyReturn, fdoNoTestFileCreate, fdoHideMRUPlaces, fdoHidePinnedPlaces, fdoNoDereferenceLinks, fdoDontAddToRecent, fdoForceShowHidden, fdoDefaultNoMiniMode, fdoForcePreviewPaneOn };
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| enum | public | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | Vcl.Dialogs |
Description
The settings in TFileDialogOption determine the behavior of a TCustomFileDialog file dialog. TFileDialogOptions is a set of TFileDialogOption. These options are the same as the options for the Microsoft IFileDialog::GetOptions and IFileDialog::SetOptions functions.
The following table lists the possible values:
| Value | Meaning |
|---|---|
|
fdoOverWritePrompt |
Prompt before overwriting an existing file of the same name when saving a file. This is a default for save dialogs. |
|
fdoStrictFileTypes |
The file extension of a saved file being must match the selected file type. |
|
fdoNoChangeDir |
Unused. |
|
fdoPickFolders |
Choose folders rather than files. |
|
fdoForceFileSystem |
Returned items must be file system items. |
|
fdoAllNonStorageItems |
Allow users to choose any item in the Shell namespace. This flag cannot be combined with fdoForceFileSystem. |
|
fdoNoValidate |
Do not check for situations preventing applications from opening selected files, such as sharing violations or access denied errors. |
|
fdoAllowMultiSelect |
Allow selecting multiple items in an open dialog. |
|
fdoPathMustExist |
Items returned must be in an existing folder. This is a default. |
|
fdoFileMustExist |
Items returned must exist. This is a default value for open dialogs. |
|
fdoCreatePrompt |
Prompt for creation if returned item in save dialog does not exist. This does not create the item. |
|
fdoShareAware |
For a sharing violation opening a file, call the application back for guidance. This flag is overridden by fdoNoValidate. |
|
fdoNoReadOnlyReturn |
Do not return read-only items. |
|
fdoNoTestFileCreate |
Do not test creation of returned item from save dialogs. If not set, the calling application must handle errors discovered in the creation test. |
|
fdoHideMRUPlaces |
Hide places of recently opened or saved items. |
|
fdoHidePinnedPlaces |
Hide pinned places from which users can choose. |
|
fdoNoDereferenceLinks |
Shortcuts are not treated as their target items, allowing applications to open .lnk files. |
|
fdoDontAddToRecent |
Do not add the item being opened or saved to the list of recent places. |
|
fdoForceShowHidden |
Show hidden items. |
|
fdoDefaultNoMiniMode |
Open save dialog box in expanded mode in which users can browse folders. Expanded mode is set and unset by clicking the button in the lower-left corner of a save dialog box. |
|
fdoForcePreviewPaneOn |
Display the preview pane. |