QDrag Class

        QDrag *drag = new QDrag(this);
        QMimeData *mimeData = new QMimeData;

        mimeData->setText(commentEdit->toPlainText());
        drag->setMimeData(mimeData);

    drag->setHotSpot(QPoint(drag->pixmap().width()/2,
                            drag->pixmap().height()));

成员函数文档

[explicit] QDrag::QDrag(QObject *dragSource)

为由 `dragSource` 指定的控件创建一个新的拖拽对象。

[virtual noexcept] QDrag::~QDrag()

销毁拖动对象。

[signal] void QDrag::actionChanged(Qt::DropAction action)

当与拖拽操作相关的action 发生变化时，会发出此信号。

另请参阅 targetChanged()。

[static] void QDrag::cancel()

取消由 Qt 发起的拖拽操作。

另请参阅 exec()。

Qt::DropAction QDrag::defaultAction() const

返回此拖放操作的默认建议放置操作。

另请参阅 exec() 和supportedActions()。

QPixmap QDrag::dragCursor(Qt::DropAction action) const

返回action 的拖动光标。

另请参阅 setDragCursor()。

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions = Qt::MoveAction)

启动拖放操作，并在操作完成后返回一个值，该值指示所请求的放置操作。用户可选择的放置操作在supportedActions 中指定。系统将按以下顺序从允许的操作中选择默认建议的操作：移动、复制和链接。

注意：在 Linux 和 macOS 上，拖放操作可能需要一些时间，但此函数不会阻塞事件循环。在操作执行期间，其他事件仍会传递给应用程序。在 Windows 上，操作期间 Qt 事件循环会被阻塞。

另请参阅 cancel()。

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions, Qt::DropAction defaultDropAction)

启动拖放操作，并在操作完成后返回一个值，该值表示请求的放置操作。用户可选择的放置操作在supportedActions 中指定。

defaultDropAction 用于确定当用户在不使用修饰键的情况下执行拖放操作时，系统将建议哪种操作。

注意：在 Linux 和 macOS 上，拖放操作可能需要一些时间，但此函数不会阻塞事件循环。在操作执行期间，其他事件仍会传递给应用程序。 在 Windows 上，操作期间 Qt 事件循环会被阻塞。不过，Windows 上的QDrag::exec() 会频繁调用 processEvents()，以保持 GUI 的响应性。如果在拖拽操作进行期间调用了任何循环或操作，将会阻塞该拖拽操作。

QPoint QDrag::hotSpot() const

返回热区相对于光标左上角的位置。

另请参阅 setHotSpot()。

QMimeData *QDrag::mimeData() const

返回由拖拽对象封装的 MIME 数据。

另请参阅 setMimeData()。

QPixmap QDrag::pixmap() const

返回用于表示拖放操作中数据的位图。

另请参阅 setPixmap()。

void QDrag::setDragCursor(const QPixmap &cursor, Qt::DropAction action)

为action 设置拖动cursor 。这允许您覆盖默认的原生光标。若要恢复使用action 的原生光标，请将空的QPixmap 作为cursor 传入。

注意：为 IgnoreAction 设置拖动光标可能并非在所有平台上都有效。经测试，X11 和 macOS 上可正常工作。Windows 不支持此功能。

另请参阅 dragCursor()。

void QDrag::setHotSpot(const QPoint &hotspot)

将热区的位置（相对于所用像素图的左上角）设置为由hotspot 指定的点。

注意：在 X11 环境下，如果热点导致像素图直接显示在光标正下方，则像素图可能无法跟上鼠标的移动。

另请参阅 hotSpot()。

void QDrag::setMimeData(QMimeData *data)

将数据设置为发送至指定的 MIMEdata 。数据的所有权将转移至QDrag 对象。

另请参阅 mimeData()。

void QDrag::setPixmap(const QPixmap &pixmap)

将pixmap 设置为用于在拖放操作中表示数据的像素图。只能在开始拖动之前设置像素图。

另请参阅 pixmap()。

QObject *QDrag::source() const

返回拖拽对象的源。这是拖拽操作的发起源所在的小部件。

Qt::DropActions QDrag::supportedActions() const

返回此拖放操作的所有可能的释放操作集合。

另请参阅 exec() 和defaultAction()。

QObject *QDrag::target() const

返回拖放操作的目标。这是拖放对象被释放的控件。

[signal] void QDrag::targetChanged(QObject *newTarget)

当拖放操作的目标发生变化时，会发出此信号，此时新目标为newTarget 。

另请参阅 target() 和actionChanged()。