Documentation: add details about handling of FL_DND_RELEASE event

see also STR #3399.
This commit is contained in:
ManoloFLTK
2024-05-13 14:58:14 +02:00
parent 5b3dd72e4e
commit a28a7c381d
+8 -2
View File
@@ -342,8 +342,14 @@ The mouse has moved out of the widget.
\subsection events_fl_dnd_release FL_DND_RELEASE \subsection events_fl_dnd_release FL_DND_RELEASE
The user has released the mouse button dropping data into The user has released the mouse button dropping data into
the widget. If the widget returns 1, it will receive the data in the widget. When the receiving widget's handle() method gets the FL_DND_RELEASE
the immediately following \p FL_PASTE event. event, it should return 1 to accept the dragged data. Processing of this event must not
use code that would make unrelated events be sent to the application
(opening a dialog window for example) or that
would communicate with the dragging process. The next
event received by the handle() method will then be an FL_PASTE event.
The handle() method should process this FL_PASTE event rapidly to prevent the dragging
process from failing with a timeout error.
\section events_fl_misc Other events \section events_fl_misc Other events