Browser (leaf, event)

A browser on a collection of text strings.


Contents (Items takes precedence):

Items GP
(TextList)
The contents of the browser.
Example: (Items "red" "blue"). When this property is accessed at runtime, the TextList is passed a single text string, with \n used to separate entries. GetTextProperty replaces the entire contents of the browser and sets the selection to NIL. PutTextProperty returns the elements in the browser, from top to bottom.
From
(Text)
If present, names a resource from which the initial browser contents will be taken.

Choices (Value takes precedence):

Value GP
(Integer, -1)
The position of the selected item. 0 means the first item; -1 means no item is selected.
Select GP
(Text)
The text of the selected item. PutTextProperty selects the first matching item if there is one; otherwise it selects nothing. GetTextProperty returns the text of the selected item, or NIL is there is no selection.
Quick
(Boolean, FALSE)
If true, every selection action is reported as an event. Otherwise, only double-click actions are reported.

Behavior
Displays items vertically, with a scrollbar at the left. Clicking selects the item under the mouse. Double-clicking on an item generates an event on the second up-click. If Quick is true, single-clicking on an item generates an event on the up-click.
Shape
At minimum, large enough to hold its scrollbar plus the single string "XXXX" in the font being used. Infinitely stretchable in both dimensions.
See Also
MultiBrowser