Returns or sets the options for the Open dialog box.
Object.OpenOptions [ = enOpenOptions ]
The OpenOptions property syntax has the following parts:
|
Name |
Type |
Description |
|
Object |
ACommonDialog |
ACommonDialog object |
|
enOpenOptions |
An integer specifying the options for the Open dialog box. |
enumACommonDialogOpenOptions can be one of the following:
|
Name |
Value |
Description |
|
acdlgOpenOptionsAllowMultiselect |
0x00000200 |
Specifies that the File Name list box allows multiple selections. |
|
acdlgOpenOptionsCreatePrompt |
0x00002000 |
If the user specifies a file that does not exist, this flag causes the dialog box to prompt the user for permission to create the file. |
|
acdlgOpenOptionsDirectory (v51) |
0x10000000 |
This flag will allow directory browsing and selection. |
|
acdlgOpenOptionsExplorer |
0x00080000 |
The dialog uses the new Explorer style. |
|
acdlgOpenOptionsExtensionDifferent |
0x00000400 |
Specifies that the user typed a file name extension that differs from the extension specified by DefaultExt. The function does not use this flag if DefaultExt is not specified. |
|
acdlgOpenOptionsFileMustExist |
0x00001000 |
Specifies that the user can type only names of existing files in the File Name entry field. If this flag is specified and the user enters an invalid name, the dialog box displays a warning in a message box. If this flag is specified, the acdlgPathMustExist flag is also used. |
|
acdlgOpenOptionsHideReadOnly |
0x00000004 |
Hides the Read Only check box. |
|
acdlgOpenOptionsLongNames |
0x00200000 |
For old style dialog boxes, this flag causes the dialog box to use long filenames. If this flag is not specified, or if the acdlgAllowMultiSel flag is also set, old style dialog boxes use short filenames (8.3 format) for filenames with spaces. Explorer style dialog boxes ignore this flag and always display long filenames. |
|
acdlgOpenOptionsNoChangeDir |
0x00000008 |
Restores the current directory to its original value if the user changed the directory while searching for files. |
|
acdlgOpenOptionsNoDereferenceLinks |
0x00100000 |
Directs the dialog box to return the path and file name of the selected shortcut (.LNK) file. If this value is not specified, the dialog box returns the path and file name of the file referenced by the shortcut. |
|
acdlgOpenOptionsNoLongNames |
0x00040000 |
For old style dialog boxes, this flag causes the dialog box to use short filenames (8.3 format). Explorer style dialog boxes ignore this flag and always display long filenames. |
|
acdlgOpenOptionsNoReadOnlyReturn |
0x00008000 |
Specifies that the returned file does not have the Read Only check box checked and is not in a write-protected directory. |
|
acdlgOpenOptionsNoValidate |
0x00000100 |
Specifies that the common dialog boxes allow invalid characters in the returned file name. |
|
acdlgOpenOptionsOverwritePrompt |
0x00000002 |
Causes the dialog box to generate a message box if the selected file already exists. |
|
acdlgOpenOptionsPathMustExist |
0x00000800 |
Specifies that the user can type only valid paths and filenames. |
|
acdlgOpenOptionsReadOnly |
0x00000001 |
Causes the Read Only check box to be checked initially when the dialog box is created. |
|
acdlgOpenOptionsShareAware |
0x00004000 |
The network sharing violation is ignored and the dialog box returns the selected file name. |
More than one Open option may be selected with the use of an OR expression.
The following statement changes the options of the ACommonDialog to hide read only files:
cdlg1.OpenOptions=acdlgOpenOptionsHideReadOnly
The following example (v5) selects a directory and also sets initial directory:
form.cdlg.OpenOptions=acdlgOpenOptionsDirectory
cdlg.InitialDir=tbAutoSavePath.Text
if cdlg.ShowOpen()=acdlgRetValOk
tbAutoSavePath.Text=cdlg.FileName
endif