Dialogs: improve descriptions of several TOpenOptions.

(Also reduce the changes of future merge conflicts in this area).
This commit is contained in:
Bart 2025-04-17 22:55:55 +02:00
parent 4e5e964bec
commit 9c6f77640d

View File

@ -184,32 +184,31 @@ type
{ TOpenDialog }
TOpenOption = (
ofReadOnly,
ofOverwritePrompt, // if selected file exists shows a message, that file
// will be overwritten
ofHideReadOnly, // hide read only file
ofNoChangeDir, // do not change current directory
ofShowHelp, // show a help button
ofNoValidate,
ofAllowMultiSelect,// allow multiselection
ofExtensionDifferent, // set after the dialog is executed (so, don't set it yourself) if DefaultExt <> '' and Extension <> DefaultExt
ofPathMustExist, // shows an error message if selected path does not exist
ofFileMustExist, // shows an error message if selected file does not exist
ofCreatePrompt,
ofShareAware,
ofNoReadOnlyReturn,// do not return filenames that are readonly
ofNoTestFileCreate,
ofNoNetworkButton,
ofNoLongNames,
ofOldStyleDialog,
ofNoDereferenceLinks,// do not resolve links while dialog is shown (only on Windows, see OFN_NODEREFERENCELINKS)
ofNoResolveLinks, // do not resolve links after Execute
ofEnableIncludeNotify,
ofEnableSizing, // dialog can be resized, e.g. via the mouse
ofDontAddToRecent, // do not add the path to the history list
ofForceShowHidden, // show hidden files
ofViewDetail, // details are OS and interface dependent
ofAutoPreview // Windows Vista+: Indicates to the Open dialog box that the preview pane should always be displayed. );
ofReadOnly, // Causes the Read Only check box to be selected initially when the dialog box is created. This flag indicates the state of the Read Only check box when the dialog box is closed.
ofOverwritePrompt, // If selected file exists, show a message that file will be overwritten.
ofHideReadOnly, // Windows only: Hides the Read Only check box (pre-Vista).
ofNoChangeDir, // Do not change current directory.
ofShowHelp, // Show a help button.
ofNoValidate, // Windows only: Disable file name validation. Allow file names with invalid characters.
ofAllowMultiSelect, // Allow multi-selection in dialog.
ofExtensionDifferent, // Option is set after the dialog is executed (so, don't set it yourself) if DefaultExt<>'' and Extension<>DefaultExt.
ofPathMustExist, // Show an error message if selected path does not exist.
ofFileMustExist, // Show an error message if selected file does not exist.
ofCreatePrompt, // Windows only: Enable a verification prompt when a file or directory needs to be created for a file dialog.
ofShareAware, // Include the OFN_SHAREAWARE flag on the Windows platform.
ofNoReadOnlyReturn, // Do not return file names that are read-only.
ofNoTestFileCreate, // Windows only: the OS does not check if the item as specified in the TSaveDialog can actually be created.
ofNoNetworkButton, // Windows only: Disable and hide the Network button on the Windows platform.
ofNoLongNames, // Windows only (with ofOldStyleDialog): Disables long file names and force use the 8.3 file names format.
ofOldStyleDialog, // Windows only: Shows the dialog in the old Win9x style.
ofNoDereferenceLinks, // Windows only: When choosing a file shortcut (*.lnk), return the shortcut itself, not the target file.
ofNoResolveLinks, // Do not resolve links after Execute.
ofEnableIncludeNotify, // Not used (defined for compatibility with Delphi).
ofEnableSizing, // Dialog can be resized, e.g. via the mouse.
ofDontAddToRecent, // Windows only: Do not add the path to the history list.
ofForceShowHidden, // Show hidden files.
ofViewDetail, // Details are OS and interface dependent.
ofAutoPreview // Windows Vista+: Indicates to the Open dialog box that the preview pane should always be displayed.
);
TOpenOptions = set of TOpenOption;