Clase wxDropSource
Esta clase representa una fuente para una operación de arrastrar y soltar.
Funciones miembro
wxDropSource()
wxDropSource::wxDropSource( wxWindow * win = NULL, const wxCursor & iconCopy = wxNullCursor, const wxCursor & iconMove = wxNullCursor, const wxCursor & iconNone = wxNullCursor )
Este constructor requiere que se llame a SetData() más tarde.
hay que tener en cuenta que el tipo de iconCopy y los parámetros posteriores difieren entre los distintos ports: son cursores en Windows y OS X pero iconos para GTK. Se debería utilizar la macro wxDROP_ICON() en programas portables en lugar de utilizar directamente cualquiera de estos tipos.
Disponibilidad: solo disponible para los ports wxMSW, wxOSX/Cocoa.
Parámetros
- win
- La ventana que inicia la operación de arrastrar y soltar.
- iconCopy
- El icono o cursor utilizado como feedback para la operación de copia.
- iconMove
- El icono o cursor utilizado para la operación de mover.
- iconNone
- El icono o cursor utilizado para la respuesta cuando no se puede realizar la operación.
wxDropSource()
wxDropSource::wxDropSource( wxDataObject & data, wxWindow * win = NULL, const wxCursor & iconCopy = wxNullCursor, const wxCursor & iconMove = wxNullCursor, const wxCursor & iconNone = wxNullCursor )
El constructor toma un wxDataObject.
Hay que tener en cuenta que el tipo de iconCopy y los parámetros subsiguientes difieren entre los diferentes ports: se trata de cursores en Windows y OS X pero de iconos para GTK. Debería utilizar la macro wxDROP_ICON() en programas portables en lugar de utilizar directamente cualquiera de estos tipos.
Disponibilidad: solo disponible para los ports wxMSW, wxOSX/Cocoa.
Parámetros
- data
- Los datos asociados a la fuente de arrastre.
- win
- La ventana que inicia la operación de arrastrar y soltar.
- iconCopy
- El icono o cursor utilizado como feedback para la operación de copia.
- iconMove
- El icono o cursor utilizado para la operación de mover.
- iconNone
- El icono o cursor utilizado para la respuesta cuando no se puede realizar la operación.
wxDropSource()
wxDropSource::wxDropSource( wxWindow * win = NULL, const wxIcon & iconCopy = wxNullIcon, const wxIcon & iconMove = wxNullIcon, const wxIcon & iconNone = wxNullIcon )
Este constructor requiere que llame a SetData() más tarde.
Esta es la versión específica para wxGTK del constructor que toma wxIcon en lugar de wxCursor como los otros ports.
Disponibilidad: solo disponible para el port wxGTK.
Parámetros
- win
- La ventana que inicia la operación de arrastrar y soltar.
- iconCopy
- El icono o cursor utilizado como feedback para la operación de copia.
- iconMove
- El icono o cursor utilizado para la operación de mover.
- iconNone
- El icono o cursor utilizado para la respuesta cuando no se puede realizar la operación.
wxDropSource()
wxDropSource::wxDropSource( wxDataObject & data, wxWindow * win = NULL, const wxIcon & iconCopy = wxNullIcon, const wxIcon & iconMove = wxNullIcon, const wxIcon & iconNone = wxNullIcon )
El constructor que toma un wxDataObject.
Esta es la versión específica para wxGTK del constructor que toma wxIcon en lugar de wxCursor como los otros ports.
Disponibilidad: solo disponible para el port wxGTK.
Parámetros
- data
- Los datos asociados con el origen del drop.
- win
- La ventana que inicia la operación de arrastrar y soltar.
- iconCopy
- El icono o cursor utilizado como feedback para la operación de copia.
- iconMove
- El icono o cursor utilizado para la operación de mover.
- iconNone
- El icono o cursor utilizado para la respuesta cuando no se puede realizar la operación.
DoDragDrop()
virtual wxDragResult wxDropSource::DoDragDrop(int flags = wxDrag_CopyOnly)
Inicia la operación de arrastrar y soltar que finalizará cuando el usuario suelte el ratón.
Llamarlo en respuesta a una pulsación del botón del ratón, por ejemplo.
Parámetros
- flags
- Si se incluye wxDrag_AllowMove en los flags, los datos pueden ser movidos y no solo copiados como es el caso por defecto de wxDrag_CopyOnly. Si se especifica wxDrag_DefaultMove (que incluye la bandera anterior), mover no solo es posible sino que se convierte en la operación por defecto.
Valor de retorno
La operación solicitada por el usuario, puede ser wxDragCopy, wxDragMove, wxDragLink, wxDragCancel o wxDragNone si se ha producido un error.
GetDataObject()
wxDataObject* wxDropSource::GetDataObject()
Devuelve el objeto wxDataObject que ha sido asignado previamente.
GiveFeedback()
virtual bool wxDropSource::GiveFeedback(wxDragResult effect)
Se puede dar alguna respuesta personalizada a la interfaz de usuario durante la operación de arrastrar y soltar anulando esta función.
Es llamada en cada movimiento del ratón, por lo que su implementación no debe ser demasiado lenta.
Parámetros
- effect
- El efecto a implementar. Uno de wxDragCopy, wxDragMove, wxDragLink y wxDragNone.
Valor de retorno
false si quieres feedback por defecto, o true si implementas tu propio feedback. El valor de retorno es ignorado bajo GTK.
SetCursor()
void wxDropSource::SetCursor( wxDragResult res, const wxCursor & cursor )
Establece el icono a utilizar para un determinado resultado de arrastre.
Parámetros
- res
- El resultado de arrastre para el que se establecerá el icono.
- cursor
- El icono a mostrar cuando se produce este resultado de arrastre.
Disponibilidad: solo disponible para los ports wxMSW, wxOSX/Cocoa.
SetData()
void wxDropSource::SetData(wxDataObject & data)
Establece el wxDataObject de datos asociado con la fuente de caída.
Esto no borrará ningún dato asociado previamente.
SetIcon()
void wxDropSource::SetIcon( wxDragResult res, const wxIcon & icon )
Establece el icono a utilizar para un determinado resultado de arrastre.
Parámetros
- res
- El resultado de arrastre para el que se establecerá el icono.
- icon
- El icono que se mostrará cuando se produzca este resultado de arrastre.
Disponibilidad: solo disponible para el port wxGTK.