CREATES A SYSTEM OBJECT SAVE_DIALOG_PIC AND ALLOCATES IT NUMBER N AS REFERENCE
ACTION
The command SAVE_DIALOG_PIC N creates a system object SAVE_DIALOG_PIC, and allocates it a number N. The number N will be used to designate the SAVE_DIALOG_PIC.
The created SAVE_DIALOG_PIC can then be used through the appropriated statements : FILTER, FILE_DIALOG, DIR_DIALOG or FILE_NAME$(N), but it is not visible.
A SAVE_DIALOG_PIC displays a dialog box to give a name to a file to be saved with the function FILE_NAME$(). The graphic file is displayed in the dialog box when selected.
A SAVE_DIALOG_PIC cannot generate an event.
Remark: by default, the SAVE_DIALOG_PIC 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_PIC.
SYNTAX:
SAVE_DIALOG_PIC N
USE ERROR EXAMPLE
rem create an SAVE_DIALOG_PIC
save_dialog_pic 1
rem then use it
a$=file_name$(1)
SAVE_DIALOG_PIC
SAVE_DIALOG_PIC N
SEE ALSO
OPEN_DIALOG
SAVE_DIALOG
OPEN_DIALOG_PIC
FILE_DIALOG
FILE_NAME$()
FILTER
DIR_DIALOG