Q3DragObject Class Reference
[Qt3Support module]

bool Q3DragObject::drag ()

Starts a drag operation using the contents of this object, using DragDefault mode.

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 Q3UriDrag are references) then the return value should always be ignored, as the target is expected to directly manipulate the content referred to by the drag object. 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 start a blocking modal event loop that will not dispatch any QTimers.

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

This is an overloaded function.

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 Q3DragObject::DragMode.) Normally one of the simpler drag(), dragMove(), or dragCopy() functions would be used instead.