Method XbpFileDialog():saveAs() Foundation
Activates the file dialog for saving a file.
:saveAs( [<cDefaultFile>], ; [<lFileList>], ; [<lCenter>] ) --> cFileName | NIL
When the file dialog is closed using the "OK" pushbutton, this method returns the entire file name as a character string including the drive and directory. If the dialog is not closed using the "OK" pushbutton, the return value is NIL.
The :saveAs() method displays and activates the file dialog. The user can specify a file in any directory on any drive using the file dialog. The user makes a selection by pressing the "OK" pushbutton. This also closes the dialog and this method returns the selected file name including its drive and directory. The dialog can also be closed using the "Cancel" pushbutton or the dialog's window menu. In either of these cases, no file has been selected and this method returns NIL.
The file dialog is generally activated using :saveAs() when a user needs to save a file (or save it under a different name). When opening a file, the file dialog is generally activated using the :open() method.
On Windows platforms, the file list is not disabled if parameter <lFileList> is .F. (false). Furthermore, a file name that denotes an existing file is not rejected. Instead, the user is prompted whether the file should be overwritten and the name of the file is returned if the user acknowledges.
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.