CopperSpice API  1.9.2
Public Methods | List of all members
QDragMoveEvent Class Reference
CsGui | Drag and Drop | Event Classes

The QDragMoveEvent class provides an event which is sent while a drag and drop action is in progress. More...

Inheritance diagram for QDragMoveEvent:
QDropEvent QEvent QDragEnterEvent

Public Methods

 QDragMoveEvent (const QPoint &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Type type=DragMove)
 
 ~QDragMoveEvent ()
 
void accept ()
 
void accept (const QRect &xRect)
 
QRect answerRect () const
 
void ignore ()
 
void ignore (const QRect &xRect)
 
- Public Methods inherited from QDropEvent
 QDropEvent (const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Type type=Drop)
 
void acceptProposedAction ()
 
Qt::DropAction dropAction () const
 
Qt::KeyboardModifiers keyboardModifiers () const
 
const QMimeData * mimeData () const
 
Qt::MouseButtons mouseButtons () const
 
QPoint pos () const
 
const QPointF & posF () const
 
Qt::DropActions possibleActions () const
 
Qt::DropAction proposedAction () const
 
void setDropAction (Qt::DropAction action)
 
QObject * source () const
 
- Public Methods inherited from QEvent
 QEvent (const QEvent &other)
 
 QEvent (Type type)
 
virtual ~QEvent ()
 
void accept ()
 
void ignore ()
 
bool isAccepted () const
 
QEvent & operator= (const QEvent &other)
 
void setAccepted (bool accepted)
 
bool spontaneous () const
 
Type type () const
 

Additional Inherited Members

- Public Types inherited from QEvent
enum  Type
 
- Static Public Methods inherited from QEvent
static int registerEventType (int hint=-1)
 

Detailed Description

The QDragMoveEvent class provides an event which is sent while a drag and drop action is in progress. A widget will receive drag move events repeatedly while the drag is within its boundaries, if it accepts drop events and enter events. The widget should examine the event to see what kind of data it provides, and call the accept() method to accept the drop if appropriate.

The rectangle supplied by the answerRect() method can be used to restrict drops to certain parts of the widget. For example, we can check whether the rectangle intersects with the geometry of a certain child widget and only call acceptProposedAction() if that is the case.

This class inherits most of its functionality from QDropEvent.

See also
QDragEnterEvent, QDragLeaveEvent, QDropEvent

Constructor & Destructor Documentation

QDragMoveEvent::QDragMoveEvent ( const QPoint &  pos,
Qt::DropActions  actions,
const QMimeData *  data,
Qt::MouseButtons  buttons,
Qt::KeyboardModifiers  modifiers,
Type  type = DragMove 
)

Creates a QDragMoveEvent of the required type indicating the mouse is at position pos given within a widget.

The mouse and keyboard states are specified by buttons and modifiers. The actions describe the types of drag and drop operation which are possible. The drag data is passed as MIME-encoded information in data.

Warning
Do not attempt to create a QDragMoveEvent yourself. These objects rely on the CopperSpice internal state.
QDragMoveEvent::~QDragMoveEvent ( )

Destroys the event.

Method Documentation

void QDragMoveEvent::accept ( )
inline

Calls QDropEvent::accept().

void QDragMoveEvent::accept ( const QRect &  xRect)
inline

The same as accept(), but also notifies that future moves will also be acceptable if they remain within the xRect given on the widget. This can improve performance, but may also be ignored by the underlying system.

If the rectangle is empty then drag move events will be sent continuously. This is useful if the source is scrolling in a timer event.

QRect QDragMoveEvent::answerRect ( ) const
inline

Returns the rectangle in the widget where the drop will occur if accepted. You can use this information to restrict drops to certain places on the widget.

void QDragMoveEvent::ignore ( )
inline

Calls QDropEvent::ignore().

void QDragMoveEvent::ignore ( const QRect &  xRect)
inline

The opposite of the accept(const QRect &) function. Moves within the xRect are not acceptable, and will be ignored.