RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
Dialogs.TFileDialogOption Enumeration

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.

Pascal
TFileDialogOption = (
  fdoOverWritePrompt,
  fdoStrictFileTypes,
  fdoNoChangeDir,
  fdoPickFolders,
  fdoForceFileSystem,
  fdoAllNonStorageItems,
  fdoNoValidate,
  fdoAllowMultiSelect,
  fdoPathMustExist,
  fdoFileMustExist,
  fdoCreatePrompt,
  fdoShareAware,
  fdoNoReadOnlyReturn,
  fdoNoTestFileCreate,
  fdoHideMRUPlaces,
  fdoHidePinnedPlaces,
  fdoNoDereferenceLinks,
  fdoDontAddToRecent,
  fdoForceShowHidden,
  fdoDefaultNoMiniMode,
  fdoForcePreviewPaneOn
);
C++
enum TFileDialogOption {
  fdoOverWritePrompt,
  fdoStrictFileTypes,
  fdoNoChangeDir,
  fdoPickFolders,
  fdoForceFileSystem,
  fdoAllNonStorageItems,
  fdoNoValidate,
  fdoAllowMultiSelect,
  fdoPathMustExist,
  fdoFileMustExist,
  fdoCreatePrompt,
  fdoShareAware,
  fdoNoReadOnlyReturn,
  fdoNoTestFileCreate,
  fdoHideMRUPlaces,
  fdoHidePinnedPlaces,
  fdoNoDereferenceLinks,
  fdoDontAddToRecent,
  fdoForceShowHidden,
  fdoDefaultNoMiniMode,
  fdoForcePreviewPaneOn
};

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.  

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!