Clase wDropTarget
Esta clase representa un objetivo para una operación de arrastrar y soltar.
Jerarquía:
Se le puede asociar un wxDataObject y, por defecto, este objeto se llenará con los datos de la fuente de arrastre, si los formatos de datos soportados por el objeto de datos coinciden con el formato de datos de la fuente de arrastre.
Hay varias funciones virtuales definidas en esta clase que pueden ser sobrescritas para dar información visual o reaccionar de una manera más precisa, por ejemplo, no aceptando datos en toda el área de la ventana, sino sólo en una pequeña parte de ella. La secuencia normal de llamadas es OnEnter(), OnDragOver() posiblemente muchas veces, OnDrop() y finalmente OnData().
Funciones miembro
wxDropTarget()
wxDropTarget::wxDropTarget(wxDataObject * data = NULL)
Constructor.
Parámetros
- data
- son los datos que se asociarán con el destino de la caída.
~wxDropTarget()
virtual wxDropTarget::~wxDropTarget()
Destructor.
Elimina el objeto de datos asociado, si existe.
GetData()
virtual bool wxDropTarget::GetData()
Este método solo puede invocarse desde OnData().
Por defecto, este método copia los datos de la fuente de caída al wxDataObject asociado con este objetivo de caída, llamando a su método wxDataObject::SetData().
GetDataObject()
wxDataObject* wxDropTarget::GetDataObject() const
Devuelve el wxDataObject de datos asociado con el objetivo de caída.
GetDefaultAction()
wxDragResult wxDropTarget::GetDefaultAction()
Devuelve la acción por defecto para arrastrar y soltar o wxDragNone si no se especifica.
OnData()
virtual wxDragResult wxDropTarget::OnData( wxCoord x, wxCoord y, wxDragResult defResult )
OnDragOver()
virtual wxDragResult wxDropTarget::OnDragOver( wxCoord x, wxCoord y, wxDragResult defResult )
Llamada cuando el ratón está siendo arrastrado sobre el objetivo de soltar.
Por defecto, esta función devuelve el valor sugerido defResult.
Parámetros
- x
- La coordenada x del ratón.
- y
- La coordenada y del ratón.
- defResult
- Valor sugerido para el valor de retorno. Determinado por los estados de las teclas SHIFT o CONTROL.
Valor de retorno
La operación deseada o wxDragNone. Esto se utiliza para la retroalimentación óptica desde el lado de la fuente del drop, por lo general en forma de cambiar el icono.
OnDrop()
Se ejecuta cuando el usuario suelta un objeto de datos en el objetivo.
Devuelve false para vetar la operación.
Parámetros
- x
- La coordenada x del ratón.
- y
- La coordenada y del ratón.
valor de retorno
true para aceptar los datos, o false para vetar la operación.
Reimplementado en wxFileDropTarget y wxTextDropTarget.
OnEnter()
virtual wxDragResult wxDropTarget::OnEnter( wxCoord x, wxCoord y, wxDragResult defResult )
Llamada cuando el ratón entra en el objetivo de soltar.
Por defecto, se llama a OnDragOver().
Parámetros
- x
- La coordenada x del ratón.
- y
- La coordenada y del ratón.
- defResult
- Valor por defecto sugerido para el valor de retorno. Determinado por los estados de las teclas SHIFT o CONTROL.
Valor de retorno
La operación deseada o wxDragNone. Esto se utiliza para la retroalimentación óptica desde el lado de la fuente del drop, por lo general en forma de cambiar el icono.
OnLeave()
virtual void wxDropTarget::OnLeave()
Se ejecuta cuando el ratón abandona el objetivo.
SetDataObject()
void wxDropTarget::SetDataObject(wxDataObject * data)
Establece el wxDataObject de datos asociado con el objetivo del drop y elimina cualquier objeto de datos asociado previamente.
SetDefaultAction()
void wxDropTarget::SetDefaultAction(wxDragResult action)
Establece la acción por defecto para arrastrar y soltar.
Utiliza wxDragMove o wxDragCopy para establecer la acción por defecto para mover o copiar y utiliza wxDragNone (por defecto) para establecer la acción por defecto especificada por la inicialización del arrastre (ver wxDropSource::DoDragDrop()).