QDragObject

NAME

SYNOPSIS

Inherits QObject and QMimeSource.

Inherited by QStoredDrag, QTextDrag, QImageDrag, and QIconDrag.

Public Members

Static Public Members

Protected Members

DESCRIPTION

QDragObject is the base class for all data that needs to be transferred between and within applications, both for drag and drop and for the clipboard.

See the Drag-and-drop documentation for an overview of how to provide drag and drop in your application.

See the QClipboard documentation for an overview of how to provide cut-and-paste in your application.

The drag() function is used to start a drag operation. You can specify the DragMode in the call or use one of the convenience functions dragCopy(), dragMove() or dragLink(). The drag source where the data originated is retrieved with source(). If the data was dropped on a widget within the application, target() will return a pointer to that widget. Specify the pixmap to display during the drag with setPixmap().

See also Drag And Drop Classes.  

Member Type Documentation

QDragObject::DragMode

QDragObject::DragDefault - The mode is determined heuristically.

QDragObject::DragCopy - The data is copied, never moved.

QDragObject::DragMove - The data is moved, if dragged at all.

QDragObject::DragLink - The data is linked, if dragged at all.

QDragObject::DragCopyOrMove - The user chooses the mode by using a control key to switch from the default.

MEMBER FUNCTION DOCUMENTATION

QDragObject::QDragObject ( QWidget * dragSource = 0, const char * name = 0 )

Note that the drag object will be deleted when dragSource is deleted.  

QDragObject::~QDragObject () [virtual]

bool QDragObject::drag ()

The function returns TRUE if the caller should delete the original copy of the dragged data (but see target()); otherwise returns FALSE.

If the drag contains references to information (e.g. file names in a QUriDrag are references) then the return value should always be ignored, as the target is expected to manipulate the referred-to content directly. On X11 the return value should always be correct anyway, but on Windows this is not necessarily the case (e.g. the file manager starts a background process to move files, so the source must not delete the files!)

Note that on Windows the drag operation will spin a blocking modal event loop that will not dispatch any QTimers.

Example: dirview/dirview.cpp.  

bool QDragObject::drag ( DragMode mode ) [virtual protected]

Starts a drag operation using the contents of this object.

At this point, the object becomes owned by Qt, not the application. You should not delete the drag object or anything it references. The actual transfer of data to the target application will be done during future event processing - after that time the drag object will be deleted.

Returns TRUE if the dragged data was dragged as a move, indicating that the caller should remove the original source of the data (the drag object must continue to have a copy); otherwise returns FALSE.

The mode specifies the drag mode (see QDragObject::DragMode.) Normally one of the simpler drag(), dragMove(), or dragCopy() functions would be used instead.  

void QDragObject::dragCopy ()

See also drag(), dragMove(), and dragLink().

Example: iconview/simple_dd/main.cpp.  

void QDragObject::dragLink ()

See also drag(), dragCopy(), and dragMove().  

bool QDragObject::dragMove ()

See also drag(), dragCopy(), and dragLink().  

QPixmap QDragObject::pixmap () const

QPoint QDragObject::pixmapHotSpot () const

void QDragObject::setPixmap ( QPixmap pm, const QPoint & hotspot ) [virtual]

The hotspot is the point on (or off) the pixmap that should be under the cursor as it is dragged. It is relative to the top-left pixel of the pixmap.

Warning: We have seen problems with drag cursors on different graphics hardware and driver software on Windows. Setting the graphics acceleration in the display settings down one tick solved the problems in all cases.

Example: fileiconview/qfileiconview.cpp.  

void QDragObject::setPixmap ( QPixmap pm ) [virtual]

Uses a hotspot that positions the pixmap below and to the right of the mouse pointer. This allows the user to clearly see the point on the window which they are dragging the data onto.  

QWidget * QDragObject::source ()

QWidget * QDragObject::target () [static]

This can be useful for detecting the case where drag and drop is to and from the same widget.

SEE ALSO

COPYRIGHT

AUTHOR

BUGS