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