Q3DragObject Class Reference
|
Constant | Value | Description |
---|---|---|
Q3DragObject::DragDefault | 0 | The mode is determined heuristically. |
Q3DragObject::DragCopy | 1 | The data is copied. |
Q3DragObject::DragMove | 2 | The data is moved. |
Q3DragObject::DragLink | 3 | The data is linked. |
Q3DragObject::DragCopyOrMove | 4 | The user chooses the mode by using the Shift key to switch from the default copy mode to move mode. |
Constructs a drag object called name with a parent dragSource.
Note that the drag object will be deleted when the dragSource is deleted.
Destroys the drag object, canceling any drag and drop operation in which it is involved.
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.
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.
Starts a drag operation using the contents of this object, using DragCopy mode. Be sure to read the constraints described in drag().
See also drag(), dragMove(), and dragLink().
Starts a drag operation using the contents of this object, using DragLink mode. Be sure to read the constraints described in drag().
See also drag(), dragCopy(), and dragMove().
Starts a drag operation using the contents of this object, using DragMove mode. Be sure to read the constraints described in drag().
Returns true if the 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.
See also drag(), dragCopy(), and dragLink().
Returns the currently set pixmap, or a null pixmap if none is set.
See also setPixmap() and QPixmap::isNull().
Returns the currently set pixmap hotspot.
See also setPixmap().
Set the pixmap, pm, to display while dragging the object. The platform-specific implementation will use this where it can - so provide a small masked pixmap, and do not assume that the user will actually see it. For example, cursors on Windows 95 are of limited size.
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.
See also pixmap().
This is an overloaded function.
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 where they are dragging the data.
Returns a pointer to the widget where this object originated (the drag source).
After the drag completes, this function will return the QWidget which received the drop, or 0 if the data was dropped on another application.
This can be useful for detecting the case where drag and drop is to and from the same widget.
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Trademarks | Qt 4.5.2 |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |