## wxListEvent

A list event holds information about events associated with wxListCtrl objects.

Derived from

wxNotifyEvent
wxCommandEvent
wxEvent
wxObject

Include files

<wx/listctrl.h>

Event table macros

To process input from a list control, use these event handler macros to direct input to member functions that take a wxListEvent argument.

EVT_LIST_BEGIN_DRAG(id, func) | Begin dragging with the left mouse button.
EVT_LIST_BEGIN_RDRAG(id, func) | Begin dragging with the right mouse button.
EVT_LIST_BEGIN_LABEL_EDIT(id, func) | Begin editing a label. This can be prevented by calling Veto().
EVT_LIST_END_LABEL_EDIT(id, func) | Finish editing a label. This can be prevented by calling Veto(). Not sent when editing was cancelled.
EVT_LIST_DELETE_ITEM(id, func) | Delete an item.
EVT_LIST_DELETE_ALL_ITEMS(id, func) | Delete all items.
EVT_LIST_ITEM_SELECTED(id, func) | The item has been selected.
EVT_LIST_ITEM_DESELECTED(id, func) | The item has been deselected.
EVT_LIST_ITEM_ACTIVATED(id, func) | The item has been activated (ENTER or double click).
EVT_LIST_ITEM_FOCUSED(id, func) | The currently focused item has changed.
EVT_LIST_ITEM_MIDDLE_CLICK(id, func) | The middle mouse button has been clicked on an item.
EVT_LIST_ITEM_RIGHT_CLICK(id, func) | The right mouse button has been clicked on an item.
EVT_LIST_KEY_DOWN(id, func) | A key has been pressed.
EVT_LIST_INSERT_ITEM(id, func) | An item has been inserted.
EVT_LIST_COL_CLICK(id, func) | A column (m_col) has been left-clicked.
EVT_LIST_COL_RIGHT_CLICK(id, func) | A column (m_col) (which can be -1 if the click occured outside any column) has been right-clicked.
EVT_LIST_COL_BEGIN_DRAG(id, func) | The user started resizing a column - can be vetoed.
EVT_LIST_COL_DRAGGING(id, func) | The divider between columns is being dragged.
EVT_LIST_COL_END_DRAG(id, func) | A column has been resized by the user.
EVT_LIST_CACHE_HINT(id, func) | Prepare cache for a virtual list control

See also

wxListCtrl

Members

wxListEvent::wxListEvent
wxListEvent::GetCacheFrom
wxListEvent::GetCacheTo
wxListEvent::GetKeyCode
wxListEvent::GetIndex
wxListEvent::GetColumn
wxListEvent::Cancelled
wxListEvent::GetPoint
wxListEvent::GetLabel
wxListEvent::GetText
wxListEvent::GetImage
wxListEvent::GetData
wxListEvent::GetMask
wxListEvent::GetItem

### wxListEvent::wxListEvent

wxListEvent(WXTYPE commandType = 0, int id = 0)

Constructor.

### wxListEvent::GetCacheFrom

long GetCacheFrom() const

For `EVT_LIST_CACHE_HINT` event only: return the first item which the list control advises us to cache.

### wxListEvent::GetCacheTo

long GetCacheTo() const

For `EVT_LIST_CACHE_HINT` event only: return the last item (inclusive) which the list control advises us to cache.

### wxListEvent::GetKeyCode

int GetKeyCode() const

Key code if the event is a keypress event.

### wxListEvent::GetIndex

long GetIndex() const

The item index.

### wxListEvent::GetColumn

int GetColumn() const

The column position: it is only used with `COL` events. For the column dragging events, it is the column to the left of the divider being dragged, for the column click events it may be -1 if the user clicked in the list control header outside any column.

### wxListEvent::Cancelled

bool Cancelled() const

TRUE if this event is an end edit event and the user cancelled the edit.

### wxListEvent::GetPoint

wxPoint GetPoint() const

The position of the mouse pointer if the event is a drag event.

### wxListEvent::GetLabel

const wxString& GetLabel() const

The label.

### wxListEvent::GetText

const wxString& GetText() const

The text.

### wxListEvent::GetImage

int GetImage() const

The image.

### wxListEvent::GetData

long GetData() const

The data.

### wxListEvent::GetMask

long GetMask() const

The mask.

### wxListEvent::GetItem

const wxListItem& GetItem() const

An item object, used by some events. See also wxListCtrl::SetItem.