diff options
| -rw-r--r-- | FL/names.h | 9 | ||||
| -rw-r--r-- | documentation/src/events.dox | 3 | ||||
| -rw-r--r-- | documentation/src/subclassing.dox | 10 |
3 files changed, 17 insertions, 5 deletions
diff --git a/FL/names.h b/FL/names.h index 1c3cca4b0..a58e0c1c5 100644 --- a/FL/names.h +++ b/FL/names.h @@ -42,10 +42,9 @@ \b Example: \code #include <FL/names.h> // array will be defined here - // MyWidget's event handler - int MyWidget::handle(int e) { + int MyClass::handle(int e) { printf("Event was %s (%d)\n", fl_eventnames[e], e); - /* ..resulting output might be e.g. "Event was FL_PUSH (1)".. */ + // ..resulting output might be e.g. "Event was FL_PUSH (1)".. [..] } \endcode @@ -86,11 +85,11 @@ const char * const fl_eventnames[] = \b Example: \code #include <FL/names.h> // array will be defined here - int MyWidget::my_callback(Fl_Widget *w, void*) { + int MyClass::my_callback(Fl_Widget *w, void*) { int fnum = w->labelfont(); // Resulting output might be e.g. "Label's font is FL_HELVETICA (0)" printf("Label's font is %s (%d)\n", fl_fontnames[fnum], fnum); - /* ..resulting output might be e.g. "Label's font is FL_HELVETICA (0)".. */ + // ..resulting output might be e.g. "Label's font is FL_HELVETICA (0)".. [..] } \endcode diff --git a/documentation/src/events.dox b/documentation/src/events.dox index 21eb3f0b6..9ea3df10c 100644 --- a/documentation/src/events.dox +++ b/documentation/src/events.dox @@ -25,6 +25,9 @@ of the \p handle() method. +Event numbers can be converted to their actual names using the \ref fl_eventnames[] array +defined in \#include <FL/names.h>; see next chapter for details. + In the next chapter, the \ref subclassing_events "MyClass::handle()" example shows how to override the diff --git a/documentation/src/subclassing.dox b/documentation/src/subclassing.dox index 57c004165..4d452ccc1 100644 --- a/documentation/src/subclassing.dox +++ b/documentation/src/subclassing.dox @@ -302,6 +302,16 @@ You must return non-zero if your \p handle() method uses the event. If you return zero, the parent widget will try sending the event to another widget. +For debugging purposes, event numbers can be printed as their actual event names +using the fl_eventnames[] array, e.g.: +\code + #include <FL/names.h> // defines fl_eventnames[] + [..] + int MyClass::handle(int e) { + printf("Event was %s (%d)\n", fl_eventnames[e], e); // e.g. "Event was FL_PUSH (1)" + [..] +\endcode + \section subclassing_drawing Drawing the Widget The \p draw() virtual method is called when FLTK wants |