ProvideX V8.20 > Language Reference > 2. Directives

139

Format 2: Check

GET_FILE_BOX READ path$,dir$,window$[ex_list$[,def_ex$,]][,ERR=stmtref]

Use the READ format to make sure that the file you want returned exists; e.g.,

0010 GET_FILE_BOX READ X$,"C:\Program Files\Sage

Software\ProvideX\","File to View"

Format 3: Write

GET_FILE_BOX WRITE path$,dir$,window$[ex_list$[,df_ex$,]][,ERR=stmtref]

Use the WRITE format to save or rewrite the file. If you do this and a user selects a

file that already exists, ProvideX will confirm that the file is to be overwritten prior

returning to the program; e.g.,

0010 GET_FILE_BOX WRITE X$,LWD,"Report file",

"Report files|*.RPT,All files|*.*,","RPT"

This allows the user to have a filename with the default extension .RPT and gives

the user a list of files of two types--Report files (*.RPT) and All files (*.*).

Format 4: Multiple Selection

GET_FILE_BOX READ LIST path$,dir$,window$[ex_list$[,df_ex$,]][,ERR=stmtref]

Use LIST to specify multiple selections for GET_FILE_BOX READ. If a single entry is

selected, then path$ will contain the full path of the file (as with a GET_FILE_BOX

READ). If more than one entry is selected, then path$ will consist of the full path of

the first item terminated by SEP, followed by a comma-delimited list of the other

selected files.

Note: Windows ignores selected directories. This format is not supported in the text

version of GET_FILE_BOX.

Format 5: Directories/Folders Only

GET_FILE_BOX DIRECTORY path$,dir$,prompt$[,root$][,ERR=stmtref]

Use this format to select a directory/folder from a list. The contents of prompt$ is

displayed inside the dialog box above the directory display. The dialog box caption

reads: "Browse for folder".

For Windows XP or later. The optional root$ parameter sets the highest level

directory in which browsing can occur (overriding what is set in dir$). The terms

"My Computer" and "My Documents" can be used as well as the full path to an

existing folder.