Author: greg.ercolano
Date: 2013-03-23 14:24:18 -0700 (Sat, 23 Mar 2013)
New Revision: 9846
Log:
Expanded docs for Fl_Browser_ to define the supported
keyboard navigation behavior.
Modified:
branches/branch-1.3/FL/Fl_Browser_.H
Modified: branches/branch-1.3/FL/Fl_Browser_.H
===================================================================
--- branches/branch-1.3/FL/Fl_Browser_.H 2013-03-23 18:40:53 UTC (rev
9845)
+++ branches/branch-1.3/FL/Fl_Browser_.H 2013-03-23 21:24:18 UTC (rev
9846)
@@ -54,6 +54,25 @@
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.
+
+ Keyboard navigation of browser items
+ ------------------------------------
+ The keyboard navigation of browser items is only possible if
+ visible_focus() is enabled. If disabled, the widget rejects keyboard focus;
+ Tab and Shift-Tab focus navigation will skip the widget.
+
+ In 'Select' and 'Normal' mode, the widget rejects keyboard focus;
+ no navigation keys are supported (other than scrollbar positioning).
+
+ In 'Hold' mode, the widget accepts keyboard focus, and Up/Down arrow
+ keys can navigate the selected item.
+
+ In 'Multi' mode, the widget accepts keyboard focus, and Up/Down arrow
+ keys navigate the focus box; Space toggles the current item's selection,
+ Enter selects only the current item (deselects all others). If Shift
+ (or Ctrl) is combined with Up/Down arrow keys, the current item's
+ selection state is extended to the next item. In this way one can
+ extend a selection or de-selection.
*/
class FL_EXPORT Fl_Browser_ : public Fl_Group {
int position_; // where user wants it scrolled to
_______________________________________________
fltk-commit mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-commit
