SAVE_DIALOG

SAVE_DIALOG N

CREATES A SYSTEM OBJECT SAVE_DIALOG AND ALLOCATES IT NUMBER N AS REFERENCE

  • Type: Command
  • Parameter: 1
  • Group: System Objects Creation

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

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • A SAVE_DIALOG makes the "Save File" common dialog box available to give a file name to save with the function FILE_NAME$().

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than or equal to 0.
  • If number N is already used for a system object number.

EXAMPLE

rem create an SAVE_DIALOG

save_dialog 1

rem then use it

a$=file_name$(1)

SEE ALSO

OPEN_DIALOG

OPEN_DIALOG_PIC

SAVE_DIALOG_PIC

FILE_DIALOG

FILE_NAME$()

FILTER

DIR_DIALOG