diff options
| author | ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com> | 2024-05-13 14:58:14 +0200 |
|---|---|---|
| committer | ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com> | 2024-05-13 14:58:14 +0200 |
| commit | a28a7c381df51a40d2ec2ffc07041d9cdd293fb2 (patch) | |
| tree | 4dadbc65115b5d336622f7f888c0fcedf9423e9d /documentation | |
| parent | 5b3dd72e4e7958312c22f756896dfc05db8e777d (diff) | |
Documentation: add details about handling of FL_DND_RELEASE event
see also STR #3399.
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/src/events.dox | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/documentation/src/events.dox b/documentation/src/events.dox index 9a6ad6328..8ac2747dc 100644 --- a/documentation/src/events.dox +++ b/documentation/src/events.dox @@ -342,8 +342,14 @@ The mouse has moved out of the widget. \subsection events_fl_dnd_release FL_DND_RELEASE The user has released the mouse button dropping data into -the widget. If the widget returns 1, it will receive the data in -the immediately following \p FL_PASTE event. +the widget. When the receiving widget's handle() method gets the FL_DND_RELEASE +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 |