diff --git a/docs/xml/lcl/dialogs.xml b/docs/xml/lcl/dialogs.xml index 78c976f698..5fffaf4076 100644 --- a/docs/xml/lcl/dialogs.xml +++ b/docs/xml/lcl/dialogs.xml @@ -1388,15 +1388,15 @@ Allows file names with invalid characters. -Allows a file name with an extension which does not match the filters or -default extension in a file dialog. +Indicates that a non-blank extension which differs from the default extension +was entered using a file open dialog. -Shows an error message if selected path does not exist. +Shows an error message if an entered file path does not exist. -Shows an error message if selected file does not exist. +Shows an error message if an entered file does not exist. @@ -1484,6 +1484,111 @@ set, it is enabled during execution of the dialog. + + +Widgetset-specific open options which cannot be mapped to the standard values +in TOpenOptions. + + +

+Values from TOpenOptionEx are stored in the TOpenOptionsEx set type +used to implement the OptionsEx property in TOpenDialog. +

+

+The current implementation contains values that are specific to the IFileDialog +options available in Windows Vista or later versions. +

+

+Values which are intentionally not supported include: ofDefaultNoMiniMode and +ofHideMruPlaces. These values are not supported as of Windows 7. +

+
+ +Added in LCL version 4.0. + + + + + +
+ + +Hides items shown by default in the view's navigation pane. (Windows Vista+) + + + + +Indicates to the Open dialog box that the preview pane should always be displayed. (Windows Vista+) + + + + +In a Save dialog, restrict the file extension to a file type available in the Filter property for the dialog. (Windows Vista+) + + + + +Turns the dialog into a TSelectDirectoryDialog. (Windows Vista+) + + + + +The OK button will be disabled until the user navigates the view or edits the +filename (if applicable). (Windows Vista+) + + + + +Ensures that returned items are file system items. (Windows Vista+) + + + + +Allows the user to choose any item in the Shell namespace, not just those with +SFGAO_STREAM or SFGAO_FILESYSTEM attributes. This flag cannot be combined with +FOS_FORCEFILESYSTEM. (Windows Vista+) + + + + + +Set type used to store values from the TOpenOptionEx enumeration. + + +

+TOpenOptionsEx is a set type used to store zero (0) or more values +from the TOpenOptionEx enumeration. It is the type used to implement +the OptionsEx property in TOpenDialog, and contains the widgetset-specific +options enabled for a dialog. +

+

+In the current implementation, TOpenOptionsEx contains values specific to +Windows Vista or later versions. It contains values which cannot be mapped +directly to values in the TOpenOption enumeration. +

+
+ +Added in LCL version 4.0. + + + + + + + + +
+ + + +Mapped to the ofHidePinnedPlaces option in TOpenOptionEx. Maintains code +compatibility with older Delphi versions. + + +Added in LCL version 4.0. + + + Set constant with the default Open Dialog options used in TOpenDialog. @@ -1994,6 +2099,31 @@ method is used to apply changes from the widgetset class instance. + + +Widgetset-specific options enabled for the dialog. + + +

+OptionsEx is a TOpenOptionsEx property which contains the +widgetset-specific options enabled when the dialog is executed. It can contain +zero (0) or more values from the TOpenOptionEx enumeration. The default value +for the property is an empty set ([]). +

+

+OptionsEx is used in the widgetset class instance to apply values which cannot +be represented using TOpenOptions and TOpenOption, which are used on all of the +supported LCL platforms. In the current LCL version, OptionsEx is used for the +Windows platform and supports Windows Vista or later version. +

+
+ + + + + +
+ Event signalled when a new directory is selected in the dialog.