SaveAsOptions Property (ACommonDialog)

Returns or sets the options for the SaveAs dialog box.

Syntax

Object.SaveAsOptions [ = enSaveOptions ]

The SaveAsOptions property syntax has the following parts:

 

Name

Type

Description

Object

ACommonDialog

ACommonDialog object

enSaveOptions

enumACommonDialogSaveAsOptions

An integer specifying the options for the SaveAs dialog box.

Where

enumACommonDialogSaveAsOptions can be one of the following:

 

Name

Value

Description

acdlgSaveAsOptionsAllowMultiselect

0x00000200

Specifies that the File Name list box allows multiple selections.

acdlgSaveAsOptionsCreatePrompt

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.

acdlgSaveAsOptionsExplorer

0x00080000

The dialog uses the new Explorer style.

acdlgSaveAsOptionsExtensionDifferent

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.

acdlgSaveAsOptionsFileMustExist

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.

acdlgSaveAsOptionsLongNames

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.

acdlgSaveAsOptionsNoChangeDir

0x00000008

Restores the current directory to its original value if the user changed the directory while searching for files.

acdlgSaveAsOptionsNoDereferenceLinks

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.

acdlgSaveAsOptionsNoLongNames

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.

acdlgSaveAsOptionsNoReadOnlyReturn

0x00008000

Specifies that the returned file does not have the Read Only check box checked and is not in a write-protected directory.

acdlgSaveAsOptionsNoValidate

0x00000100

Specifies that the common dialog boxes allow invalid characters in the returned file name.

acdlgSaveAsOptionsOverwritePrompt

0x00000002

Causes the dialog box to generate a message box if the selected file already exists.

acdlgSaveAsOptionsPathMustExist

0x00000800

Specifies that the user can type only valid paths and filenames.

acdlgSaveAsOptionsShareAware

0x00004000

The network sharing violation is ignored and the dialog box returns the selected file name.

Comments

More than one SaveAs option may be selected with the use of an OR expression.

Example

The following statement changes the options of the ACommonDialog to not create a directory and the file must exist already:

cdlg1.SaveAsOptions=acdlgSaveAsOptionsNoChangeDir or acdlgSaveAsOptionsFileMustExist

Applies to

ACommonDialog

See Also

DefaultExt, FileName, InitialDir, SaveAsOptions, ShowSaveAs