Contents Up Previous Next

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.