QGraphicsScene::dragMoveEvent()デバッグ＆トラブルシューティング完全版

2025-04-26

基本的な概念

dragMoveEvent
ドラッグ中にマウスがシーン上を移動したときに発生するイベントです。
QGraphicsScene
グラフィカルアイテムを管理するシーンです。
ドラッグ＆ドロップ
ユーザーがマウスでアイテムをクリックし、それを別の場所に移動させる操作です。

QGraphicsScene::dragMoveEvent()の役割

このイベントハンドラは、以下の目的で使用されます。

ドラッグ中のアイテムの追跡
マウスの動きに合わせて、ドラッグ中のアイテムの位置を更新します。
ドラッグ中のアイテムのビジュアルフィードバック
ドラッグ中のアイテムの移動先を示すために、プレビューやハイライトを表示します。
ドラッグ中のデータの検証
ドラッグ中のデータがシーンにドロップ可能かどうかを検証します。
ドロップターゲットの決定
ドラッグ中のアイテムがどのアイテムまたは領域にドロップされるかを決定します。
カスタムのドラッグ＆ドロップ動作の実装
ドラッグ＆ドロップ操作に関する独自のロジックを実装します。

QGraphicsScene::dragMoveEvent()の引数

このイベントハンドラは、QGraphicsSceneDragDropEventオブジェクトを引数として受け取ります。QGraphicsSceneDragDropEventオブジェクトには、以下の情報が含まれています。

source()
ドラッグを開始したアイテム。
proposedAction()
提案されたドロップアクション。
possibleActions()
サポートされているドロップアクション。
mimeData()
ドラッグ中のMIMEデータ。
screenPos()
マウスカーソルのスクリーン座標。
scenePos()
マウスカーソルのシーン座標。
pos()
マウスカーソルのシーン座標。

実装例

以下は、QGraphicsScene::dragMoveEvent()をオーバーライドして、ドラッグ中のアイテムの位置を追跡する例です。

#include <QGraphicsScene>
#include <QGraphicsSceneDragDropEvent>
#include <QDebug>

class MyGraphicsScene : public QGraphicsScene {
public:
    MyGraphicsScene(QObject *parent = nullptr) : QGraphicsScene(parent) {}

protected:
    void dragMoveEvent(QGraphicsSceneDragDropEvent *event) override {
        qDebug() << "dragMoveEvent: " << event->scenePos();
        QGraphicsScene::dragMoveEvent(event);
    }
};

この例では、dragMoveEvent()が呼び出されるたびに、マウスカーソルのシーン座標をコンソールに出力します。

QGraphicsSceneDragDropEvent::setAccepted(true)を呼び出すことで、イベントを受け入れ、QGraphicsSceneDragDropEvent::setAccepted(false)で拒否が可能です。
QGraphicsSceneDragDropEvent::ignore()を呼び出すことで、イベントを無視できます。
QGraphicsSceneDragDropEvent::acceptProposedAction()を呼び出すことで、提案されたドロップアクションを受け入れることができます。
QGraphicsScene::dragMoveEvent()をオーバーライドする際には、基底クラスのQGraphicsScene::dragMoveEvent(event)を呼び出すことを推奨します。これにより、デフォルトのドラッグ＆ドロップ動作が維持されます。

一般的なエラーとトラブルシューティング

- 原因
  - シーンでドラッグ＆ドロップが有効になっていない (setAcceptDrops(true)が呼び出されていない)。
  - ドラッグを開始したアイテムが、シーンにドラッグ可能なデータを提供していない。
  - イベントフィルタがイベントをブロックしている。
- トラブルシューティング
  - QGraphicsScene::setAcceptDrops(true)がシーンで呼び出されているか確認します。
  - ドラッグを開始するアイテムが、QMimeDataを提供しているか確認します。
  - イベントフィルタがインストールされている場合、dragMoveEvent()をブロックしていないか確認します。
  - qDebug()などを利用して、ドラッグ開始時にイベントが発行されているか確認します。
ドラッグ中のアイテムが意図しない位置に移動する
- 原因
  - dragMoveEvent()内でアイテムの位置を誤って更新している。
  - シーン座標とアイテム座標の変換が正しく行われていない。
  - アイテムのアンカーポイントが予想外の位置にある。
- トラブルシューティング
  - dragMoveEvent()内の位置更新ロジックを再確認します。
  - QGraphicsScene::scenePos()とQGraphicsItem::mapToScene()/QGraphicsItem::mapFromScene()を使用して、座標変換が正しく行われているか確認します。
  - アイテムのsetTransformOriginPoint()を確認し、アンカーポイントが意図した位置にあるか確認します。
  - アイテムの親アイテムの影響を受けて位置が意図しない場所に移動していないか確認します。
ドラッグ中のビジュアルフィードバックが正しく表示されない
- 原因
  - ドラッグ中のプレビューやハイライトの描画ロジックに誤りがある。
  - アイテムの描画順序が正しくない。
  - シーンの更新が遅延している。
- トラブルシューティング
  - プレビューやハイライトの描画ロジックを再確認します。
  - アイテムのzValue()を調整して、描画順序を修正します。
  - QGraphicsScene::update()を呼び出して、シーンを強制的に再描画します。
  - 描画処理が重たい場合、処理を最適化するか、非同期処理を検討します。
ドロップアクションが正しく処理されない
- 原因
  - QGraphicsSceneDragDropEvent::acceptProposedAction()が適切に呼び出されていない。
  - QGraphicsSceneDragDropEvent::proposedAction()の値が予想と異なる。
  - ドロップターゲットがドロップアクションをサポートしていない。
- トラブルシューティング
  - QGraphicsSceneDragDropEvent::acceptProposedAction()を呼び出して、ドロップアクションを受け入れるようにします。
  - QGraphicsSceneDragDropEvent::proposedAction()の値を確認し、サポートされているドロップアクションと一致するか確認します。
  - ドロップターゲットがドロップアクションをサポートしているか確認します。QGraphicsSceneDragDropEvent::possibleActions()でサポートされているアクションが確認できます。
MIMEデータが正しく処理されない
- 原因
  - ドラッグ中に提供されるMIMEデータの形式が正しくない。
  - ドロップターゲットがMIMEデータを正しく解析できない。
- トラブルシューティング
  - ドラッグ中に提供されるMIMEデータの形式を確認します。
  - ドロップターゲットでのMIMEデータの解析ロジックを再確認します。
  - カスタムのMIMEタイプを使用している場合、正しく登録されているか確認します。

デバッグのヒント

ステップ実行デバッガを使用して、コードの実行を追跡します。
グラフィックスビューのデバッグモードを有効にして、描画の問題を特定します。
qDebug()を使用して、dragMoveEvent()の引数や変数の値をログ出力します。

例1: ドラッグ中のアイテムの位置を追跡し、コンソールに出力する

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QGraphicsSceneDragDropEvent>
#include <QDebug>

class MyGraphicsScene : public QGraphicsScene {
public:
    MyGraphicsScene(QObject *parent = nullptr) : QGraphicsScene(parent) {
        // ドロップを有効にする
        setAcceptDrops(true);
    }

protected:
    void dragMoveEvent(QGraphicsSceneDragDropEvent *event) override {
        // ドラッグ中のマウス座標をコンソールに出力
        qDebug() << "dragMoveEvent: scenePos =" << event->scenePos();

        // 基底クラスのdragMoveEventを呼び出す（デフォルトの動作を維持）
        QGraphicsScene::dragMoveEvent(event);
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    MyGraphicsScene scene;
    QGraphicsView view(&scene);

    // ドラッグ可能な矩形アイテムを追加
    QGraphicsRectItem *rectItem = scene.addRect(0, 0, 100, 100);
    rectItem->setFlag(QGraphicsItem::ItemIsMovable);

    view.show();
    return app.exec();
}

この例では、MyGraphicsSceneクラスを作成し、dragMoveEvent()をオーバーライドしています。ドラッグ中にマウスがシーン上を移動すると、dragMoveEvent()が呼び出され、その中でマウスのシーン座標がコンソールに出力されます。矩形アイテムはドラッグ可能な状態になっています。

例2: ドラッグ中のアイテムのプレビューを表示する

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QGraphicsSceneDragDropEvent>
#include <QDebug>

class MyGraphicsScene : public QGraphicsScene {
public:
    MyGraphicsScene(QObject *parent = nullptr) : QGraphicsScene(parent) {
        setAcceptDrops(true);
        previewItem = nullptr;
    }

protected:
    void dragMoveEvent(QGraphicsSceneDragDropEvent *event) override {
        // プレビューアイテムが存在しない場合、作成
        if (!previewItem) {
            previewItem = addRect(0, 0, 100, 100, QPen(Qt::DashLine), QBrush(Qt::lightGray));
            previewItem->setZValue(1000); // プレビューを最前面に表示
        }

        // プレビューアイテムの位置を更新
        previewItem->setPos(event->scenePos() - QPointF(50, 50)); // 矩形の中心がマウス座標になるように調整

        // 基底クラスのdragMoveEventを呼び出す
        QGraphicsScene::dragMoveEvent(event);
    }

    void dragLeaveEvent(QGraphicsSceneDragDropEvent *event) override {
        // ドラッグが終了したらプレビューアイテムを削除
        if (previewItem) {
            removeItem(previewItem);
            delete previewItem;
            previewItem = nullptr;
        }
        QGraphicsScene::dragLeaveEvent(event);
    }

private:
    QGraphicsRectItem *previewItem;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    MyGraphicsScene scene;
    QGraphicsView view(&scene);

    QGraphicsRectItem *rectItem = scene.addRect(0, 0, 100, 100);
    rectItem->setFlag(QGraphicsItem::ItemIsMovable);

    view.show();
    return app.exec();
}

この例では、ドラッグ中に半透明の矩形プレビューを表示します。dragMoveEvent()内でプレビューアイテムを作成し、マウスの動きに合わせて位置を更新します。dragLeaveEvent()内でプレビューアイテムを削除します。

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QGraphicsSceneDragDropEvent>
#include <QDebug>

class MyGraphicsScene : public QGraphicsScene {
public:
    MyGraphicsScene(QObject *parent = nullptr) : QGraphicsScene(parent) {
        setAcceptDrops(true);
        highlightedItem = nullptr;
    }

protected:
    void dragMoveEvent(QGraphicsSceneDragDropEvent *event) override {
        // 現在ハイライトされているアイテムをリセット
        if (highlightedItem) {
            highlightedItem->setPen(QPen(Qt::black));
            highlightedItem = nullptr;
        }

        // マウス座標にあるアイテムを検索し、ハイライト
        QGraphicsItem *item = itemAt(event->scenePos(), QTransform());
        if (item && item != event->source()) { // ドラッグ元のアイテムはハイライトしない
            highlightedItem = item;
            highlightedItem->setPen(QPen(Qt::red, 3));
        }

        QGraphicsScene::dragMoveEvent(event);
    }

private:
    QGraphicsItem *highlightedItem;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    MyGraphicsScene scene;
    QGraphicsView view(&scene);

    QGraphicsRectItem *rectItem1 = scene.addRect(0, 0, 100, 100);
    rectItem1->setFlag(QGraphicsItem::ItemIsMovable);

    QGraphicsRectItem *rectItem2 = scene.addRect(150, 150, 100, 100);

    view.show();
    return app.exec();
}

代替手法1: QGraphicsItem::mouseMoveEvent()を使用する

QGraphicsItem::mouseMoveEvent()は、アイテム上でマウスが移動したときに呼び出されます。アイテム内でドラッグ動作を処理する場合、このイベントハンドラを使用できます。

欠点
- 複数のアイテム間でのドラッグ動作を処理するのが難しい。
- シーン全体のドラッグ＆ドロップ動作を制御できない。
利点
- アイテム固有のドラッグ動作を実装しやすい。
- シーン全体のドラッグ動作を制御する必要がない場合に便利。

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QMouseEvent>
#include <QDebug>

class DraggableRectItem : public QGraphicsRectItem {
public:
    DraggableRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)
        : QGraphicsRectItem(x, y, width, height, parent), dragging(false) {}

protected:
    void mousePressEvent(QGraphicsSceneMouseEvent *event) override {
        if (event->button() == Qt::LeftButton) {
            dragging = true;
            dragOffset = event->pos();
        }
        QGraphicsRectItem::mousePressEvent(event);
    }

    void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override {
        if (dragging) {
            setPos(mapToScene(event->pos() - dragOffset));
        }
        QGraphicsRectItem::mouseMoveEvent(event);
    }

    void mouseReleaseEvent(QGraphicsSceneMouseEvent *event) override {
        if (event->button() == Qt::LeftButton) {
            dragging = false;
        }
        QGraphicsRectItem::mouseReleaseEvent(event);
    }

private:
    bool dragging;
    QPointF dragOffset;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QGraphicsScene scene;
    QGraphicsView view(&scene);

    DraggableRectItem *rectItem = new DraggableRectItem(0, 0, 100, 100);
    scene.addItem(rectItem);

    view.show();
    return app.exec();
}

この例では、DraggableRectItemクラスを作成し、mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent()をオーバーライドして、アイテムのドラッグ動作を実装しています。

代替手法2: イベントフィルタを使用する

イベントフィルタを使用すると、シーンまたはアイテムに送信されるイベントを監視し、必要に応じて処理できます。

欠点
- コードが複雑になる可能性がある。
- パフォーマンスに影響を与える可能性がある。
利点
- シーン全体のイベントを監視できる。
- 複数のアイテム間でのドラッグ動作を制御できる。
- 柔軟性が高い。

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QMouseEvent>
#include <QDebug>

class DragFilter : public QObject {
public:
    DragFilter(QGraphicsScene *scene) : QObject(scene), scene(scene), draggingItem(nullptr) {}

protected:
    bool eventFilter(QObject *obj, QEvent *event) override {
        if (event->type() == QEvent::GraphicsSceneMousePress) {
            QGraphicsSceneMouseEvent *mouseEvent = static_cast<QGraphicsSceneMouseEvent *>(event);
            if (mouseEvent->button() == Qt::LeftButton) {
                draggingItem = scene->itemAt(mouseEvent->scenePos(), QTransform());
                if (draggingItem) {
                    dragOffset = mouseEvent->pos();
                }
            }
        } else if (event->type() == QEvent::GraphicsSceneMouseMove) {
            QGraphicsSceneMouseEvent *mouseEvent = static_cast<QGraphicsSceneMouseEvent *>(event);
            if (draggingItem) {
                draggingItem->setPos(draggingItem->mapToScene(mouseEvent->pos() - dragOffset));
            }
        } else if (event->type() == QEvent::GraphicsSceneMouseRelease) {
            QGraphicsSceneMouseEvent *mouseEvent = static_cast<QGraphicsSceneMouseEvent *>(event);
            if (mouseEvent->button() == Qt::LeftButton) {
                draggingItem = nullptr;
            }
        }
        return QObject::eventFilter(obj, event);
    }

private:
    QGraphicsScene *scene;
    QGraphicsItem *draggingItem;
    QPointF dragOffset;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QGraphicsScene scene;
    QGraphicsView view(&scene);

    QGraphicsRectItem *rectItem = scene.addRect(0, 0, 100, 100);

    DragFilter *filter = new DragFilter(&scene);
    scene.installEventFilter(filter);

    view.show();
    return app.exec();
}

この例では、DragFilterクラスを作成し、eventFilter()をオーバーライドして、シーンのGraphicsSceneMousePress, GraphicsSceneMouseMove, GraphicsSceneMouseReleaseイベントを処理しています。