QDropEvent Class

メンバ関数ドキュメント

QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)

宛先ウィジェットの座標系でpos で指定されたポイントへのドロップに対応する、特定のtype のドロップイベントを構築する。

actions は、どのタイプのドラッグ＆ドロップ操作が実行できるかを示し、ドラッグデータは MIME エンコードされたデータとしてdata に格納される。

ドロップ時のマウスボタンとキーボード修飾子の状態は、buttons とmodifiers で指定される。

void QDropEvent::acceptProposedAction()

ドロップアクションを提案されたアクションに設定します。

setDropAction()、proposedAction()、accept()も参照 。

[since 6.0] Qt::MouseButtons QDropEvent::buttons() const

押されたマウスボタンを返します。

この関数は Qt 6.0 で導入されました。

Qt::DropAction QDropEvent::dropAction() const

ターゲットがデータに対して実行するアクションを返します。これは、setDropAction() を呼び出してドロップ・アクションを明示的に選択した場合は、proposedAction() で指定したアクションとは異なる可能性があります。

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

const QMimeData *QDropEvent::mimeData() const

ウィジェットにドロップされたデータと、関連する MIME タイプ情報を返します。

[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const

押された修飾キーを返します。

この関数は Qt 6.0 で導入されました。

[since 6.0] QPointF QDropEvent::position() const

ドロップが行われた位置を返します。

この関数は Qt 6.0 で導入されました。

Qt::DropActions QDropEvent::possibleActions() const

可能なドロップアクションの OR 組み合わせを返します。

dropAction()も参照ください 。

Qt::DropAction QDropEvent::proposedAction() const

提案されているドロップアクションを返します。

dropAction()も参照ください 。

void QDropEvent::setDropAction(Qt::DropAction action)

ターゲットがデータに対して実行するaction を設定する。proposed action をpossible actions のいずれかで上書きする場合に使用します。

指定可能なアクション以外のドロップ・アクションを設定した場合、ドラッグ・アンド・ドロップ操作のデフォルトはコピー操作になります。

代わりのドロップ・アクションを指定したら、acceptProposedAction() の代わりにaccept() を呼び出します。

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

QObject *QDropEvent::source() const

ドラッグ操作のソースがこのアプリケーションのウィジェットである場合、この関数はそのソースを返し、そうでない場合はnullptr を返します。操作のソースは、ドラッグをインスタンス化するために使用されるQDrag オブジェクトの最初のパラメータです。

これは、ウィジェットが自分自身にドラッグするときに特別な動作が必要な場合に便利です。

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