Improve documentation of wxDataViewCtrl mouse event handling.

Explain that catching mouse events directly doesn't work.

Also make it clear that double clicking an item can be caught by processing
wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED.

See #14111.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@71361 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2012-05-04 20:35:52 +00:00
parent e762ef8f53
commit 43868fdedc

View File

@@ -747,7 +747,9 @@ wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_DROP;
@event{EVT_DATAVIEW_SELECTION_CHANGED(id, func)} @event{EVT_DATAVIEW_SELECTION_CHANGED(id, func)}
Process a @c wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED event. Process a @c wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED event.
@event{EVT_DATAVIEW_ITEM_ACTIVATED(id, func)} @event{EVT_DATAVIEW_ITEM_ACTIVATED(id, func)}
Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED event. Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED event. This event
is triggered by double clicking an item or pressing some special key
(usually "Enter") when it is focused.
@event{EVT_DATAVIEW_ITEM_START_EDITING(id, func)} @event{EVT_DATAVIEW_ITEM_START_EDITING(id, func)}
Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_START_EDITING event. This Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_START_EDITING event. This
event can be vetoed in order to prevent editing on an item by item event can be vetoed in order to prevent editing on an item by item
@@ -788,6 +790,11 @@ wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_DROP;
Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_DROP event. Process a @c wxEVT_COMMAND_DATAVIEW_ITEM_DROP event.
@endEventTable @endEventTable
Notice that this control doesn't allow to process generic mouse events such
as @c wxEVT_LEFT_DOWN in all ports (notably it doesn't work in wxGTK). If
you need to handle any mouse events not covered by the ones above, consider
using a custom renderer for the cells that must handle them.
@library{wxadv} @library{wxadv}
@category{ctrl,dvc} @category{ctrl,dvc}
@appearance{dataviewctrl.png} @appearance{dataviewctrl.png}