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

ドラッグ＆ドロップ操作においてデータを表現するために使用されるピクマップを返します。

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

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

action のドラッグ用cursor を設定します。これにより、デフォルトのネイティブカーソルを上書きすることができます。action でネイティブカーソルを使用するように元に戻すには、cursor としてnullのQPixmap を指定してください。

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