138
GET_FILE_BOX Directive
Ask for Filename
Formats
1. Create File Box: GET_FILE_BOX path$,dir$,window$[ex_list$[,def_ex$]][,ERR=stmtref]
2. Check File Box: GET_FILE_BOX READ path$,dir$,window$[ex_list$[,def_ex$]][,ERR=stmtref]
3. Write to File Box: GET_FILE_BOX WRITE path$,dir$,window$[ex_list$[,def_ex$]][,ERR=stmtref]
4. Multiple Selection: GET_FILE_BOX READ LIST path$,dir$,window$[ex_list$[,def_ex$]][,ERR=stmtref]
5. Directories/Folders Only: GET_FILE_BOX DIRECTORY path$,dir$,prompt$[,root$][,ERR=stmtref]
Where:
dir$
Initial directory to display. String expression.
def_ext$
Default file extension to apply when creating a file. Optional. String
expression.
ex_list$
List of file extensions. Optional. String expression. Comma (or any
character) as delimiter.
path$
String variable that contains the file path. Initialize this prior to
executing this directive. See the note, below.
prompt$
Text appearing above the directory display.
root$
For Windows XP or later. Optional highest level directory in which
browsing can occur. (This parameter overrides dir$.)
stmtref
Program line number or label to transfer control to.
window$
Window title. String expression.
Note: GET_FILE_BOX is supported when you use WindX with UNIX file systems and
supported calls to [WDX]. See [WDX] Direct Action to Client Machine, p.797.
Description
Use the GET_FILE_BOX directive to display a standardized window for the user,
allowing the entry or selection of a file or directory in the system.
Format 1: Create
GET_FILE_BOX path$,dir$,window$[ex_list$[,def_ex$,]][,ERR=stmtref]
Note: The path$ variable will receive the full pathname of the file selected. Because
its initial contents will be used as the default pathname, initialize it prior to executing
this directive.
Use this format to select a file. If the initial directory string is null, ProvideX uses the
current directory. Use the form Description|*.XXX, to list standard file extensions.
You can include multiple extensions, comma-delimited (with the last extension
terminated by a comma). If desired, choose a character other than a comma to
delimit each entry. ProvideX uses the last character in ex_list$ (the comma or your
choice) as the delimiter.