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()も参照してください 。