This is the base class for browsers. To be useful it must be subclassed and several virtual functions defined. The Forms-compatable browser and the file chooser's browser are subclassed off of this.
This has been designed so that the subclass has complete control over the storage of the data, although because next() and prev() functions are used to index, it works best as a linked list or as a large block of characters in which the line breaks must be searched for.
A great deal of work has been done so that the "height" of a data object does not need to be determined until it is drawn. This is useful if actually figuring out the size of an object requires accessing image data or doing stat() on a file or doing some other slow operation.
Sorry, documentation is incomplete at this time
The constructor makes an empty browser.
The destructor deletes all list items and destroys the browser.
By default you can scroll in both directions, and the scrollbars disappear if the data will fit in the widget. has_scrollbar() changes this based on the value of h:
0 - No scrollbars
Fl_Browser_::HORIZONTAL - Only a horizontal scrollbar.
Fl_Browser_::VERTICAL - Only a vertical scrollbar.
Fl_Browser_::BOTH - The default is both scrollbars.
Fl_Browser_::HORIZONTAL_ALWAYS - Horizontal scrollbar always on, vertical always off.
Fl_Browser_::VERTICAL_ALWAYS - Vertical scrollbar always on, horizontal always off.
Fl_Browser_::BOTH_ALWAYS - Both always on.
The first form gets the default text color for the lines in the browser.
The second form sets the default text color to color.
The first form gets the default text font for the lines in the browser.
The second form sets the default text font to font
The first form gets the default text size for the lines in the browser.
The second form sets the default text size to size