Vcl.Dialogs.TFileDialogOption

From RAD Studio API Documentation
Jump to: navigation, search

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.