Clase wxDataViewEvent
Esta es la clase de evento para las notificaciones de wxDataViewCtrl.
Jerarquía:
Eventos que usan esta clase
Las siguientes macros de controlador de eventos redirigen los eventos a los controladores de funciones miembro "func" con prototipos como:
void handlerFuncName(wxDataViewEvent& event)
Macros de eventos:
- EVT_DATAVIEW_SELECTION_CHANGED(id, func)
- Procesa un evento wxEVT_DATAVIEW_SELECTION_CHANGED.
- EVT_DATAVIEW_ITEM_ACTIVATED(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_ACTIVATED.
- EVT_DATAVIEW_ITEM_EDITING_STARTED(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_EDITING_STARTED.
- EVT_DATAVIEW_ITEM_EDITING_DONE(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_EDITING_DONE.
- EVT_DATAVIEW_ITEM_COLLAPSING(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_COLLAPSING.
- EVT_DATAVIEW_ITEM_COLLAPSED(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_COLLAPSED.
- EVT_DATAVIEW_ITEM_EXPANDING(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_EXPANDING.
- EVT_DATAVIEW_ITEM_EXPANDED(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_EXPANDED.
- EVT_DATAVIEW_ITEM_VALUE_CHANGED(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_VALUE_CHANGED.
- EVT_DATAVIEW_ITEM_CONTEXT_MENU(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_CONTEXT_MENU.
- EVT_DATAVIEW_COLUMN_HEADER_CLICK(id, func)
- Procesa un evento wxEVT_DATAVIEW_COLUMN_HEADER_CLICK.
- EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK(id, func)
- Procesa un evento wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK.
- EVT_DATAVIEW_COLUMN_SORTED(id, func)
- Procesa un evento wxEVT_DATAVIEW_COLUMN_SORTED.
- EVT_DATAVIEW_COLUMN_REORDERED(id, func)
- Procesa un evento wxEVT_DATAVIEW_COLUMN_REORDERED. Actualmente, este evento no se genera cuando se utiliza la versión nativa GTK+ del control.
- EVT_DATAVIEW_ITEM_BEGIN_DRAG(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_BEGIN_DRAG que se genera cuando el usuario comienza a arrastrar un elemento válido. Este evento debe procesarse y debe llamarse a wxDataViewEvent::SetDataObject() para comenzar realmente a arrastrar el elemento.
- EVT_DATAVIEW_ITEM_DROP_POSSIBLE(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE.
- EVT_DATAVIEW_ITEM_DROP(id, func)
- Procesa un evento wxEVT_DATAVIEW_ITEM_DROP.
- EVT_DATAVIEW_CACHE_HINT(id, func)
- Procesa un evento wxEVT_DATAVIEW_CACHE_HINT.
Funciones miembro
wxDataViewEvent()
wxDataViewEvent::wxDataViewEvent()
El constructor por defecto, normalmente no debería utilizarse y existe principalmente por motivos de compatibilidad con versiones anteriores.
wxDataViewEvent()
wxDataViewEvent::wxDataViewEvent( wxEventType evtType, wxDataViewCtrl * dvc, wxDataViewColumn * column, const wxDataViewItem & item = wxDataViewItem() )
Constructor para los eventos que afectan a las columnas (y posiblemente también a los elementos).
wxDataViewEvent()
wxDataViewEvent::wxDataViewEvent( wxEventType evtType, wxDataViewCtrl * dvc, const wxDataViewItem & item )
Constructor para los eventos que afectan solo a los elementos.
wxDataViewEvent()
wxDataViewEvent::wxDataViewEvent(const wxDataViewEvent & event)
Constructor copia.
GetCacheFrom()
int wxDataViewEvent::GetCacheFrom() const
Devuelve la primera fila que se mostrará.
GetCacheTo()
int wxDataViewEvent::GetCacheTo() const
Devuelve la última fila que se mostrará.
GetColumn()
int wxDataViewEvent::GetColumn() const
Devuelve la posición de la columna en el control o -1 si el campo de columna no está disponible para este evento.
Para wxEVT_DATAVIEW_COLUMN_REORDERED, esta es la nueva posición de la columna.
GetDataBuffer()
void* wxDataViewEvent::GetDataBuffer() const
Obtiene el búfer de datos para una transferencia de datos de drop.
GetDataFormat()
wxDataFormat wxDataViewEvent::GetDataFormat() const
Obtiene el formato wxDataFormat durante una operación de arrastrar y soltar.
GetDataObject()
wxDataObject* wxDataViewEvent::GetDataObject() const
GetDataSize()
size_t wxDataViewEvent::GetDataSize() const
Obtiene el tamaño de los datos para una transferencia de datos de drop.
GetDataViewColumn()
wxDataViewColumn* wxDataViewEvent::GetDataViewColumn() const
Devuelve un puntero al wxDataViewColumn desde el que se emitió el evento o nullptr.
GetDragFlags()
int wxDataViewEvent::GetDragFlags() const
GetDropEffect()
wxDragResult wxDataViewEvent::GetDropEffect() const
Devuelve el efecto que el usuario ha solicitado que se aplique a los datos arrastrados.
Esta función se puede utilizar dentro de los controladores wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE y wxEVT_DATAVIEW_ITEM_DROP y devuelve si el usuario está intentando copiar (el valor devuelto es wxDragCopy) o mover (si el valor devuelto es wxDragMove) los datos.
Actualmente, esto sólo está disponible cuando se utiliza la versión genérica de wxDataViewCtrl (utilizada, por ejemplo, en MSW) y siempre devuelve wxDragNone en las versiones nativas de GTK y macOS.
GetItem()
wxDataViewItem wxDataViewEvent::GetItem() const
Devuelve el elemento afectado por el evento.
Hay que tener en cuenta que, para los controladores de eventos wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE y wxEVT_DATAVIEW_ITEM_DROP, el elemento puede no ser válido, lo que indica que la acción de soltar está a punto de producirse fuera del área del elemento.
GetModel()
wxDataViewModel* wxDataViewEvent::GetModel() const
Devuelve el wxDataViewModel asociado al evento.
GetPosition()
wxPoint wxDataViewEvent::GetPosition() const
Devuelve la posición de un evento del menú contextual en coordenadas del cliente.
GetProposedDropIndex()
int wxDataViewEvent::GetProposedDropIndex() const
Devuelve el índice del elemento secundario en el que se soltaría el elemento que se está arrastrando actualmente.
Esta función se puede utilizar desde los controladores wxEVT_DATAVIEW_ITEM_DROP (en todos las plataformas) y wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE (excepto cuando se utiliza la implementación nativa de GTK) para determinar la posición exacta del elemento que se está soltando.
GetValue()
const wxVariant& wxDataViewEvent::GetValue() const
Devuelve una referencia a un valor.
IsEditCancelled()
bool wxDataViewEvent::IsEditCancelled() const
Se puede utilizar para determinar si el nuevo valor va a ser aceptado en el controlador wxEVT_DATAVIEW_ITEM_EDITING_DONE.
Devuelve verdadero si se ha cancelado la edición del elemento o si el usuario ha intentado introducir un valor no válido (rechazado por wxDataViewRenderer::Validate()). Si este método devuelve falso, significa que el valor del modelo está a punto de cambiarse por el nuevo.
Hay que tener en cuenta que el controlador de eventos wxEVT_DATAVIEW_ITEM_EDITING_DONE puede llamar a wxNotifyEvent::Veto() para evitar que esto suceda.
Actualmente, la compatibilidad para configurar este campo y vetar el cambio sólo está disponible en la versión genérica de wxDataViewCtrl, es decir, en MSW, pero no en GTK ni en macOS.
SetCache()
void wxDataViewEvent::SetCache( int from, int to )
SetColumn()
void wxDataViewEvent::SetColumn(int col)
Establece el índice de columna asociado a este evento.
SetDataBuffer()
void wxDataViewEvent::SetDataBuffer(void * buf)
SetDataFormat()
void wxDataViewEvent::SetDataFormat(const wxDataFormat & format)
SetDataObject()
void wxDataViewEvent::SetDataObject(wxDataObject * obj)
Establece wxDataObject para la transferencia de datos dentro de una operación de arrastre.
Este método debe utilizarse dentro de un controlador wxEVT_DATAVIEW_ITEM_BEGIN_DRAG para asociar el objeto de datos que se va a arrastrar con el elemento.
Hay que tener en cuenta que el control toma posesión del objeto de datos, es decir, obj debe estar asignado en el montón y será eliminado por el propio wxDataViewCtrl.
SetDataSize()
void wxDataViewEvent::SetDataSize(size_t size)
SetDataViewColumn()
void wxDataViewEvent::SetDataViewColumn(wxDataViewColumn * col)
Sólo para wxEVT_DATAVIEW_COLUMN_HEADER_CLICK.
SetDragFlags()
void wxDataViewEvent::SetDragFlags(int flags)
Especifica el tipo de operación de arrastre que se va a realizar.
Este método se puede utilizar dentro de un controlador wxEVT_DATAVIEW_ITEM_BEGIN_DRAG para configurar la operación de arrastre. Los valores válidos son wxDrag_CopyOnly (predeterminado), wxDrag_AllowMove (permite mover los datos) y wxDrag_DefaultMove.
Actualmente solo es compatible con la versión genérica de wxDataViewCtrl (utilizada, por ejemplo, en MSW) y no es compatible con las versiones nativas de GTK y macOS.
SetDropEffect()
void wxDataViewEvent::SetDropEffect(wxDragResult effect)
SetItem()
void wxDataViewEvent::SetItem(const wxDataViewItem & item)
SetModel()
void wxDataViewEvent::SetModel(wxDataViewModel * model)
Establece el modelo de vista de datos asociado a este evento.
SetPosition()
void wxDataViewEvent::SetPosition( int x, int y )
SetValue()
void wxDataViewEvent::SetValue(const wxVariant & value)
Establece el valor asociado a este evento.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvent, wxCommandEvent y wxNotifyEvent.