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 （）は、GUIの反応を維持するためにprocessEvents()を頻繁に呼び出します。ドラッグ操作中にループや操作が呼び出されると、ドラッグ操作がブロックされます。

QPoint QDrag::hotSpot() const

カーソルの左上隅を基準としたホットスポットの位置を返す。

setHotSpot()も参照してください 。

QMimeData *QDrag::mimeData() const

ドラッグオブジェクトがカプセル化している MIME データを返します。

setMimeData()も参照 ください。

QPixmap QDrag::pixmap() const

ドラッグ＆ドロップ操作でデータを表現するために使用される pixmap を返します。

setPixmap()も参照してください 。

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

action のドラッグcursor を設定する。 これにより、デフォルトのネイティブカーソルをオーバーライドすることができる。action のネイティブカーソルの使用に戻すには、cursor として nullQPixmap を渡します。

注意: IgnoreActionにドラッグカーソルを設定しても、すべてのプラットフォームで動作するとは限りません。X11とmacOSは動作確認済みです。Windowsはサポートしていません。

dragCursor()も参照してください 。

void QDrag::setHotSpot(const QPoint &hotspot)

使用する pixmap の左上隅からの相対的なホットスポットの位置をhotspot で指定した点に設定する。

注意:X11の場合、ホットスポットによってカーソルの真下にpixmapが表示されると、マウスの動きにpixmapが追いつかないことがあります。

hotSpot()も参照のこと 。

void QDrag::setMimeData(QMimeData *data)

指定された MIMEdata に送信するデータを設定する。データの所有権はQDrag オブジェクトに移ります。

mimeData()も参照 。

void QDrag::setPixmap(const QPixmap &pixmap)

ドラッグ＆ドロップ操作でデータを表現するための pixmap として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()も参照してください 。