summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--FL/Fl.H15
-rw-r--r--FL/Fl_Input_.H5
2 files changed, 15 insertions, 5 deletions
diff --git a/FL/Fl.H b/FL/Fl.H
index a0db8b3bd..bc0e11691 100644
--- a/FL/Fl.H
+++ b/FL/Fl.H
@@ -165,10 +165,17 @@ public:
\see Fl::option(Fl_Option)
*/
typedef enum {
- /// When switched on, moving the text cursor beyond the start or end of
- /// a text in a text widget will change focus to the next text widget.
- /// When switched off, the cursor will stop at the end of the text.
- /// Pressing Tab or Ctrl-Tab will advance the keyboard focus.
+ /// When switched on, arrow keys will navigate focus between widgets.
+ /// Also, left/right arrow keys in text widgets will change widget focus
+ /// if the cursor is moved off the start or end of text.
+ ///
+ /// When switched off, arrow keys will not navigate focus, and in text
+ /// widgets left/right arrows will not move off the widget when the
+ /// start or end of text is reached. Pressing Tab or Ctrl-Tab will
+ /// advance the keyboard focus.
+ ///
+ /// See also: Fl_Input_::tab_nav()
+ ///
OPTION_ARROW_FOCUS = 0,
// When switched on, FLTK will use the file chooser dialog that comes
// with your operating system whenever possible. When switched off, FLTK
diff --git a/FL/Fl_Input_.H b/FL/Fl_Input_.H
index 457b98a2e..86a84f00a 100644
--- a/FL/Fl_Input_.H
+++ b/FL/Fl_Input_.H
@@ -468,6 +468,8 @@ public:
\param [in] val If \p val is 1, Tab advances focus (default).<BR>
If \p val is 0, Tab inserts a tab character (old FLTK behavior).
+
+ \see tab_nav(), Fl::OPTION_ARROW_FOCUS.
*/
void tab_nav(int val) {
tab_nav_ = val;
@@ -480,7 +482,8 @@ public:
If disabled, hitting Tab inserts a tab character into the text field.
\returns 1 if Tab advances focus (default), 0 if Tab inserts tab characters.
- \see tab_nav(int)
+
+ \see tab_nav(int), Fl::OPTION_ARROW_FOCUS.
*/
int tab_nav() const {
return tab_nav_;