listctrl.h

Clase wxListEvent

Un evento de lista contiene información sobre eventos asociados a objetos wxListCtrl.

Jerarquía:

Eventos que usan esta clase

Las siguientes macros de manejadores de eventos redirigen los eventos a manejadores de funciones miembro 'func' con prototipos como:

void handlerFuncName(wxListEvent& event)

Macros de evento:

EVT_LIST_BEGIN_DRAG(id, func): Comienza a arrastrar con el botón izquierdo del ratón.
EVT_LIST_BEGIN_RDRAG(id, func): Comienza a arrastrar con el botón derecho del ratón.
EVT_LIST_BEGIN_LABEL_EDIT(id, func: Comienza la edición de una etiqueta. Esto puede evitarse llamando a Veto().
EVT_LIST_END_LABEL_EDIT(id, func): Finaliza la edición de una etiqueta. Esto puede evitarse llamando a Veto().
EVT_LIST_DELETE_ITEM(id, func): Elimina un elemento.
EVT_LIST_DELETE_ALL_ITEMS(id, func): Elimina todos los elementos.
EVT_LIST_ITEM_SELECTED(id, func): El elemento ha sido seleccionado. Hay que tener en cuenta que el ratón es capturado por el propio control cuando se genera este evento, ver resumen de manejo de eventos.
EVT_LIST_ITEM_DESELECTED(id, func): El ítem ha sido deseleccionado. GetIndex() puede ser -1 con listas virtuales.
EVT_LIST_ITEM_ACTIVATED(id, func): El ítem ha sido activado (ENTER o doble click).
EVT_LIST_ITEM_FOCUSED(id, func): El ítem actualmente enfocado ha cambiado.
EVT_LIST_ITEM_MIDDLE_CLICK(id, func): Se ha pulsado el botón central del ratón sobre un elemento.
EVT_LIST_ITEM_RIGHT_CLICK(id, func): El botón derecho del ratón ha sido pulsado sobre un elemento.
EVT_LIST_KEY_DOWN(id, func): Se ha pulsado una tecla. GetIndex() puede ser -1 si no hay ningún elemento seleccionado.
EVT_LIST_INSERT_ITEM(id, func): Se ha insertado un elemento.
EVT_LIST_COL_CLICK(id, func): Se ha hecho clic izquierdo sobre una columna (m_col).
EVT_LIST_COL_RIGHT_CLICK(id, func): Se ha hecho clic con el botón derecho en una columna (m_col) (que puede ser -1 si el clic se ha producido fuera de cualquier columna).
EVT_LIST_COL_BEGIN_DRAG(id, func): El usuario ha comenzado a redimensionar una columna - puede ser vetado.
EVT_LIST_COL_DRAGGING(id, func): El divisor entre columnas está siendo arrastrado.
EVT_LIST_COL_END_DRAG(id, func): Una columna ha sido redimensionada por el usuario.
EVT_LIST_CACHE_HINT(id, func): Preparar caché para un control de lista virtual
EVT_LIST_ITEM_CHECKED(id, func): El elemento ha sido comprobado (nuevo desde wxWidgets 3.1.0).
EVT_LIST_ITEM_UNCHECKED(id, func): El elemento ha sido desmarcado (nuevo desde wxWidgets 3.1.0).

Funciones miembro

wxListEvent()

wxListEvent::wxListEvent( wxEventType commandType = wxEVT_NULL, int id = 0 )

Constructor.

GetCacheFrom()

long wxListEvent::GetCacheFrom() const

Sólo para el evento EVT_LIST_CACHE_HINT: devuelve el primer elemento que el control de lista nos aconseja cachear.

GetCacheTo()

long wxListEvent::GetCacheTo() const

Sólo para el evento EVT_LIST_CACHE_HINT: devuelve el último elemento (incluido) que el control de lista nos aconseja cachear.

GetColumn()

int wxListEvent::GetColumn() const

La posición de la columna: sólo se utiliza con eventos COL.

Para los eventos de arrastre de columna, es la columna a la izquierda del divisor que se está arrastrando, para los eventos de clic de columna puede ser -1 si el usuario hizo clic en la cabecera del control de lista fuera de cualquier columna.

GetData()

wxUIntPtr wxListEvent::GetData() const

Obtiene los datos.

GetImage()

int wxListEvent::GetImage() cons

Obtiene la imagen.

GetIndex()

long wxListEvent::GetIndex() const

Obtiene el índice del ítem.

GetItem()

const wxListItem& wxListEvent::GetItem() const

Un objeto item, utilizado por algunos eventos.

GetKeyCode()

int wxListEvent::GetKeyCode() const

Código de tecla si el evento es de pulsación de tecla.

GetLabel()

const wxString& wxListEvent::GetLabel() const

La (nueva) etiqueta del elemento para el evento EVT_LIST_END_LABEL_EDIT.

GetMask()

long wxListEvent::GetMask() const

Obtiene la máscara.

GetPoint()

wxPoint wxListEvent::GetPoint() const

La posición del puntero del ratón si el evento es de arrastre.

nombre()

const wxString& wxListEvent::GetText() const

Obtiene el texto.

IsEditCancelled()

bool wxListEvent::IsEditCancelled() const

Este método sólo tiene sentido para el mensaje EVT_LIST_END_LABEL_EDIT y devuelve true si la edición de la etiqueta ha sido cancelada por el usuario (GetLabel() devuelve una cadena vacía en este caso, pero no permite a la aplicación distinguir entre cancelar realmente la edición y el caso ciertamente raro de que el usuario quiera renombrarla a una cadena vacía).

SetCacheFrom()

void wxListEvent::SetCacheFrom(long cacheFrom)

SetCacheTo()

void wxListEvent::SetCacheTo(long cacheTo)

SetColumn()

void wxListEvent::SetColumn(int col)

SetIndex()

void wxListEvent::SetIndex(long index)

SetItem()

void wxListEvent::SetItem(const wxListItem & item)

SetKeyCode()

void wxListEvent::SetKeyCode(int code)

SetPoint()

void wxListEvent::SetPoint(const wxPoint & point)

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxNotifyEvent, wxCommandEvent, wxEvent y wxObject.