CREATES A SYSTEM OBJECT SAVE_DIALOG AND ALLOCATES IT NUMBER N AS REFERENCE
ACTION
The command SAVE_DIALOG N creates a system object SAVE_DIALOG, and allocates it a number N. The number N will be used to designate the SAVE_DIALOG.
The created Save_Dialog can then be used through the appropriated statements : FILTER, FILE_DIALOG, DIR_DIALOG or FILE_NAME$(), but is not visible.
A SAVE_DIALOG displays a dialog box to give a name to a file to be saved with the function FILE_NAME$().
A SAVE_DIALOG cannot generate an event.
Remark: by default, the SAVE_DIALOG is created on the FORM number 0, but another FORM can be used. For that, create a FORM by FORM N, and send it all the commands by COMMAND_TARGET_IS N before creating the SAVE_DIALOG.
SYNTAX:
SAVE_DIALOG N
USE ERROR EXAMPLE
rem create an SAVE_DIALOG
save_dialog 1
rem then use it
a$=file_name$(1)
SAVE_DIALOG
SAVE_DIALOG N
SEE ALSO
OPEN_DIALOG
OPEN_DIALOG_PIC
SAVE_DIALOG_PIC
FILE_DIALOG
FILE_NAME$()
FILTER
DIR_DIALOG