Vcl.Dialogs.TOpenOption

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TOpenOption = System.UITypes.TOpenOption;

Properties

Type Visibility Source Unit Parent
enum public Vcl.Dialogs.pas Vcl.Dialogs Vcl.Dialogs

Description

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

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.