Member variable XbpFileDialog():validatePath Foundation

Controls validation of paths entered by the user

Attribute: EXPORTED
Data type: Logical (.F.)
Description

The :validatePath instance variable controls how path information entered by the user is validated by the file dialog. If this contains the value .T. (true), any path entered or selected by the user in the file dialog is checked for availability. In this case, the system ensures that the directory returned is valid and write-enabled.

If :validatePath contains .F. (false), only limited validation is performed on the path. In this case, the file(s) returned by :open() and :saveAs() may be located in a directory that is not currently available or that is write-protected.

Effects of :validatePath on methods :open() and :saveAs()
Situation :validatePath == .T. :validatePath == .F.
Volume invalid Input is rejected Return is file name or NIL
Folder invalid Input is rejected Return is file name or NIL
Disk write-protected Input is rejected Return is file name(s)

Path management varies between platforms when :validatePath has the value .F. (false) and depends on the actions taken by the user within the file dialog. If a file with a full-qualified path is specified when the user closes the dialog, this file name is returned by methods :open() and :saveAs(), even if the specified volume or path is invalid. Results may vary between platforms, however, if only a partial path is entered by the user. On Windows NT, for example, method :open() returns NIL if the user specified an invalid path without a file name. On Windows ME, the partial path is returned instead. When the property :validatePath has the value .F. (false), it is therefore recommended that the application validates path information returned by both :open() and :saveAs().

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.