Document issues with event handlers called when mouse is captured

Notably mention that showing modal dialogs won't work in this case.

Also link to this explanation from wxListCtrl documentation as
wxEVT_LIST_ITEM_SELECTED is one of the perhaps less expected cases in
which this problem arises.

See #9973.
This commit is contained in:
Vadim Zeitlin
2019-09-29 14:57:59 +02:00
parent 7a1bc568e5
commit 66526adf7a
2 changed files with 32 additions and 2 deletions

View File

@@ -213,7 +213,9 @@ enum
All items were deleted.
Processes a @c wxEVT_LIST_DELETE_ALL_ITEMS event type.
@event{EVT_LIST_ITEM_SELECTED(id, func)}
The item has been selected.
The item has been selected. Notice that the mouse is captured by the
control itself when this event is generated, see @ref
overview_events_with_mouse_capture "event handling overview".
Processes a @c wxEVT_LIST_ITEM_SELECTED event type.
@event{EVT_LIST_ITEM_DESELECTED(id, func)}
The item has been deselected.
@@ -1426,7 +1428,9 @@ protected:
@event{EVT_LIST_DELETE_ALL_ITEMS(id, func)}
Delete all items.
@event{EVT_LIST_ITEM_SELECTED(id, func)}
The item has been selected.
The item has been selected. Notice that the mouse is captured by the
control itself when this event is generated, see @ref
overview_events_with_mouse_capture "event handling overview".
@event{EVT_LIST_ITEM_DESELECTED(id, func)}
The item has been deselected.
@event{EVT_LIST_ITEM_ACTIVATED(id, func)}