RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
Dialogs.TOpenOptions Type

TOpenOption and TOpenOptions determine the behavior of a file selection dialog.

Pascal
TOpenOptions = set of TOpenOption;
C++
TOpenOption TOpenOptions;

Dialogs

TOpenOption values determine the appearance and behavior of a file selection dialog. TOpenOptions is a set of TOpenOption values. 

The following table lists the possible values:

Value 
Meaning 
ofReadOnly  
Selects the Open As Read Only check box by default when the dialog opens.  
ofOverwritePrompt  
Generates a warning message if the user tries to select a file name that is already in use, asking whether to overwrite the existing file. (Use with save dialogs.)  
ofHideReadOnly  
Removes the Open As Read Only check box from the dialog.  
ofNoChangeDir  
After the user clicks OK, resets the current directory to whatever it was before the file-selection dialog opened.  
ofShowHelp  
Displays a Help button in the dialog.  
ofNoValidate  
Disables checking for invalid characters in file names. Allows selection of file names with invalid characters.  
ofAllowMultiSelect  
Allows users to select more than one file in the dialog.  
ofExtensionDifferent  
This flag is turned on at runtime whenever the selected filename has an extension that differs from DefaultExt. If you use this flag in an application, remember to reset it.  
ofPathMustExist  
Generates an error message if the user tries to select a file name with a nonexistent directory path.  
ofFileMustExist  
Generates an error message if the user tries to select a nonexistent file. (only applies to Open dialogs).  
ofCreatePrompt  
Generates a warning message if the user tries to select a nonexistent file, asking whether to create a new file with the specified name.  
ofShareAware  
Ignores sharing errors and allows files to be selected even when sharing violations occur.  
ofNoReadOnlyReturn  
Generates an error message if the user tries to select a read-only file.  
ofNoTestFileCreate  
Disables checking for network file protection and inaccessibility of disk drives. Applies only when the user tries to save a file in a create-no-modify shared network directory.  
ofNoNetworkButton  
Removes the Network button (which opens a Map Network Drive dialog) from the file-selection dialog. Applies only if the ofOldStyleDialog flag is on.  
ofNoLongNames  
Displays 8.3-character file names only. This option is only valid if Options also includes ofOldStyleDialog.  
ofOldStyleDialog  
Creates the older style of file-selection dialog.  
ofNoDereferenceLinks  
Disables dereferencing of Windows shortcuts. If the user selects a shortcut, assigns to FileName the path and file name of the shortcut itself (the .LNK file), rather than the file linked to the shortcut.  
ofEnableIncludeNotify  
(Windows 2000 and later.) Sends CDN_INCLUDEITEM notification messages to the dialog when the user opens a folder. A notification is sent for each item in the newly opened folder. You can use these messages to control which items appear in the folder's item list.  
ofEnableSizing  
(Windows 98 and later) Lets the Explorer-style dialog be resized with the mouse or keyboard. By default, the dialog allows this resizing regardless of the value of this option. It is only required if you provide a hook procedure or custom template. (Old style dialogs never permit resizing.)  
ofDontAddToRecent  
Prevents the file from being added to the list of recently opened files.  
ofForceShowHidden  
Ensures that hidden files are visible in the dialog.  

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!