summaryrefslogtreecommitdiff
path: root/documentation
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2007-01-24 20:55:25 +0000
committerMatthias Melcher <fltk@matthiasm.com>2007-01-24 20:55:25 +0000
commitbb96a49d1d065b0291965d651b685178d9173af3 (patch)
tree2cc6270264cda82cf7aa8a07c544a7dbf7e4b90e /documentation
parente36d3a07ce69b648b9157cf97c2aafb8f67461a9 (diff)
Updated documentation to explain which events are sent to an inactive window. This is IMHO better than "fixing" this because old code may rely on that feature. We are not losing out on anything here anyways. STR #1513.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5640 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation')
-rw-r--r--documentation/Fl_Widget.html11
1 files changed, 7 insertions, 4 deletions
diff --git a/documentation/Fl_Widget.html b/documentation/Fl_Widget.html
index ddec76f25..566d0098f 100644
--- a/documentation/Fl_Widget.html
+++ b/documentation/Fl_Widget.html
@@ -138,10 +138,13 @@ will destroy all of the child widgets and groups in that group.
<P><TT>Fl_Widget::active()</TT> returns whether the widget is
active. <TT>Fl_Widget::active_r()</TT> returns whether the
-widget and all of its parents are active. An inactive widget
-does not get any events, but it does get redrawn. A widget is
-only active if <TT>active()</TT> is true on it <I>and all of its
-parents</I>.
+widget and all of its parents are active. Inactive widgets
+will be drawn "grayed out", e.g. with less contrast than the
+active widget. Inactive widgets will not receive any keyboard or
+mouse button events. Other events (including <tt>FL_ENTER</tt>,
+<tt>FL_MOVE</tt>, <tt>FL_LEAVE</tt>, <tt>FL_SHORTCUT</tt>, and
+others) will still be sent. A widget is only active if
+<TT>active()</TT> is true on it <I>and all of its parents</I>.
<P>Changing this value will send <TT>FL_ACTIVATE</TT> or <TT>
FL_DEACTIVATE</TT> to the widget if <tt>active_r()</tt> is true.