RETURNS THE FILE NAME GIVEN BY THE SYSTEM OBJECT NUMBER N
ACTION
The function FILE_NAME$(N) returns the file name chosen by the user who handles an object of type OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
The function makes the object visible and the program is suspended until the user chooses a file name or cancels the operation.
N is the number of an object of type : OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
Remark 1: if the user clicks on the button "cancel" of the object, the function FILE_NAME$ returns the character underscore "_" as file name.
Remark 2: the keyword FILE_NAME$ ends by '$' because the returned value is a string.
SYNTAX:
Result$=FILE_NAME$(N)
USE ERROR EXAMPLE
rem create an OPEN_DIALOG
open_dialog 1
rem create a LIST
list 2
rem fill it with the file chosen by the user (open_dialog)
file_load 2,file_name$(1)
FILE_NAME$()
FILE_NAME$(N)
SEE ALSO
OPEN_DIALOG
SAVE_DIALOG
OPEN_DIALOG_PIC
SAVE_DIALOG_PIC
FILE_DIALOG
FILTER
DIR_DIALOG