diff options
| author | Matthias Melcher <fltk@matthiasm.com> | 2007-01-24 20:55:25 +0000 |
|---|---|---|
| committer | Matthias Melcher <fltk@matthiasm.com> | 2007-01-24 20:55:25 +0000 |
| commit | bb96a49d1d065b0291965d651b685178d9173af3 (patch) | |
| tree | 2cc6270264cda82cf7aa8a07c544a7dbf7e4b90e | |
| parent | e36d3a07ce69b648b9157cf97c2aafb8f67461a9 (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
| -rw-r--r-- | documentation/Fl_Widget.html | 11 |
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. |