BROWSE        Display a pop-up open file dialog box

Top  Previous  Next

Syntax:

BROWSE

[ variable ]  [ title ]  [ initdir ] [ filter ] [ options ]

Arguments:

[ variable ]

A variable to store the file name or file name with full path selected in the open file dialog box; if the variable does not  previously exist, it is created.

 

[ title ]

Optional variable or string defining a open file dialog box window title. If not specified, neither [ initdir ] nor [ filter ] may be specified.

 

[ initdir ]

Optional variable or string defining the initial folder for the open file dialog box. If not specified, [ filter ] may not be specified.

 

[ filter ]

Optional variable or string defining a filter to be used when displaying files in the open file dialog box.

Options:

/nopath

When this option is used only the file name is saved in [ variable ]. By default the full path and file name is returned.

 

 

This command not allowed when running as an NT Service or in a locked minimized window.

 

This script command displays a open file dialog box on your display that permits browsing for a user-selected file. The window title, starting folder, and a file name filter may be specified in the command. Control returns to next script command when you close the dialog by clicking on the OK or Cancel buttons. This command is useful to allow a user to make a select of a file to be processed by a running script.

 

If FileLink is running a script in a unlocked minimized window then FileLink window will be restored when this command is performed.

 

The script file can detect if the Cancel button has been clicked by testing for result code 1013 or the $ERROR variable $ERROR_PROMPT_CANCELLED.

 

  Related Commands: MESSAGEBOX, ASK, PROMPT