From bb96a49d1d065b0291965d651b685178d9173af3 Mon Sep 17 00:00:00 2001 From: Matthias Melcher Date: Wed, 24 Jan 2007 20:55:25 +0000 Subject: 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 --- documentation/Fl_Widget.html | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'documentation') 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.

Fl_Widget::active() returns whether the widget is active. Fl_Widget::active_r() 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 active() is true on it and all of its -parents. +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 FL_ENTER, +FL_MOVE, FL_LEAVE, FL_SHORTCUT, and +others) will still be sent. A widget is only active if +active() is true on it and all of its parents.

Changing this value will send FL_ACTIVATE or FL_DEACTIVATE to the widget if active_r() is true. -- cgit v1.2.3