File Browser

This statement is used to perform various functions on the File Browser. The statement is not valid when batch processing and is only performed once when not executing stepwise.

The text field may contain any of the escape sequences described in Escape Sequences. After unescaping, the text field can be a list delimited by the default list delimiter (\~) or newline characters (\n). Items in the list can be a path to a folder or a path to a file. Paths to a file are adjusted to represent their containing folder. Paths must be absolute (start with a /) or be relative to the home folder (start with ~).

The following functions are available:

Show in File Browser

If there is more than one item in the list only the first is used. If the item is a valid path, it will be displayed in the File Browser. If the list is empty, the File Browser will be displayed without modifying its current folder. Regardless, the File Browser will be displayed.

Hide File Browser

The File Browser will be hidden.

Pin folders in File Browser

Each item in the list will be added to the File Browser's list of pinned folders.

Unpin folders in File Browser

Each item in the list will be removed from the File Browser's list of pinned folders.

With the pin and unpin functions the contexts of the text field can be displayed in a multi-line editor by clicking on the control to the right of the field. \n sequences are changed to newline characters when displayed and changed back to \n sequences after editing.

The \?fb escape sequence can be used at any time to determine if the File Browser is displayed. The inserted value will be 1 if it is displayed, otherwise 0.

The Get Info statement's List of File Browser Pinned Folders can be used to extract the list of current pinned folders.

Example: clear the list of pinned folders:

Get Info: List of File Browser Pinned Folders to named variable 'list'
Unpin folders in File Browser "\<list>"