Helper (leaf, event)

A type-in field connected to a FileBrowser. A Helper is used for typing filenames, either to select a new file or to switch to another directory.


For
(Symbol)
The name of a FileBrowser. This property is required.
FirstFocus
(Boolean, FALSE)
If this Helper is in a subwindow or TSplit-child, then when that component appears, the keyboard focus will go to this Helper, and its typein field will be selected in replace-mode.
TabTo
(Symbol)
If given, this is the name of the component to which the keyboard focus wil be transferred when the user types Tab.
ExpandOnDemand
(Boolean, FALSE)
If true, the text area will grow and shrink vertically, as required, to contain the entire text.

Behavior
The helper displays the pathname of the FileBrowser's current directory. The user can also type a name in the Helper; typing Return will then activate that file in the FileBrowser.
In a non-ReadOnly FileBrowser, a Helper is necessary in order to specify a file that does not yet exist (e.g., that the application should create), as in a "Save As ..." dialog.
We recommend using (Font "fixed") in the helper.
Shape
The width is zero with infinite stretchability, and the height is as high as one line in the current font.
Notes
A Helper never generates events in its own name. It can be accessed in its own name, but this is not recommended.
See Also
DirMenu and FileBrowser