summaryrefslogtreecommitdiff
path: root/documentation/Fl.html
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2006-06-14 07:24:05 +0000
committerMatthias Melcher <fltk@matthiasm.com>2006-06-14 07:24:05 +0000
commitfee47dba98e38087c2eda233b96ea2c97e92c2f2 (patch)
tree429d80e88237fe9b60cbac4eed94d65e8c704e55 /documentation/Fl.html
parenta0cbcf3d1ddad34ffeff9ee85cb94ee1a9a1a05f (diff)
STR 1306: udated documentation to reflect limitation in Fl::delete_widget(). For a different bug, I was forced to implement an automated widget deletion system which seems to work well. I would like to reuse that for all cases that depend on 'delete_widget', making 'delete_widget' obsolete. I will change the STR accordingly.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5195 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation/Fl.html')
-rw-r--r--documentation/Fl.html11
1 files changed, 8 insertions, 3 deletions
diff --git a/documentation/Fl.html b/documentation/Fl.html
index ac42de887..a20e913d4 100644
--- a/documentation/Fl.html
+++ b/documentation/Fl.html
@@ -501,9 +501,14 @@ window and then calls the default widget callback.</p>
<H4><A NAME="Fl.delete_widget">void delete_widget(Fl_Widget*);</A></H4>
-<p>Schedules a widget for deletion when it is safe to do so. Use
-this method to delete a widget inside a callback function. When
-deleting groups or windows, you must only delete the group or
+<p>Schedules a widget for deletion at the next call to the event loop.
+Use this method to delete a widget inside a callback function.
+To avoid early deletion of widgets, this function
+should be called toward the end of a callback and only after any call
+to the event loop (<tt>Fl:wait()</tt>, <tt>Fl::flush()</tt>,
+<tt>fl_ask()</tt>, etc).</p>
+
+<p>When deleting groups or windows, you must only delete the group or
window widget and not the individual child widgets.</p>
<H4><A NAME="Fl.display">void display(const char*);</A></H4>