This function is typically used to select either a folder or file from a standard OS X file open dialog. The selected item's path will be saved in one of Variable 0 - Variable 9 or a named variable.
You can specify that you allow selecting a file or a folder or either.
You can allow multiple files or folders to be selected. When more than one item is selected, the destination variable will contain a list of items separated by the default list delimiter (\~).
When prompting for a single file, you can choose New File which causes a standard OS X save dialog to be opened.
When prompting for files you can optionally supply a list of filename extensions which will be accepted. The extensions are separated by spaces or commas. Note, you do not have to include a leading . on an extension.
When files and folders can be selected you may have to use a Test If File Exists statement to determine if a returned path is a file or folder.
The supplied text strings may contain any of the escape sequences described in Escape Sequences. Only the first non blank line of the prompt will be displayed.
You can elect to issue a beep with the prompt.
The prompt is only issued once per set of files when run stepwise.
The function is valid while batch processing but is intended to be used within the special Batch Start and Batch End inline actions.