Qtドラッグ&ドロップ入門: dragEnterEvent()でのMIMEタイプ判定とイベント処理

2025-05-27

QAbstractScrollArea::dragEnterEvent() は、Qtフレームワークにおけるドラッグ＆ドロップ操作に関連するイベントハンドラの一つです。QAbstractScrollArea は、スクロールバーを備えたスクロール可能な領域を提供するウィジェットの抽象基底クラスです。このクラスは、QScrollArea などのより具体的なスクロールウィジェットの基礎となります。

dragEnterEvent() は、ドラッグ操作がウィジェットの領域に初めて進入したときに呼び出される仮想関数です。具体的には、ユーザーが何らかのデータをドラッグし始め、そのドラッグ中のデータがこのQAbstractScrollArea（またはそのビューポート）の上に到達した瞬間に、このイベントが発生します。

役割

このイベントハンドラの主な役割は、そのウィジェットがドラッグされたデータを受け入れ可能かどうかを判断し、Qtに対してその意図を伝えることです。

イベントは QDragEnterEvent オブジェクトを引数として受け取ります。この QDragEnterEvent オブジェクトには、ドラッグされているデータ（MIMEタイプ、データ本体など）や、ドロップアクション（コピー、移動、リンクなど）に関する情報が含まれています。

実装と処理

QAbstractScrollArea のサブクラスでこの dragEnterEvent() をオーバーライド（再実装）することで、独自のドラッグ＆ドロップ処理を実装できます。

オーバーライドした関数内で通常行う処理は以下の通りです。

データの種類の確認: event->mimeData() を使用して、ドラッグされているデータのMIMEタイプを確認します。例えば、テキストデータ（text/plain）や画像データ（image/png）など、アプリケーションが処理できるデータタイプであるかを確認します。
ドロップアクションの許可: 受け入れ可能なデータである場合、event->acceptProposedAction() を呼び出して、Qtに対してこのウィジェットがドラッグされたデータを受け入れる用意があることを伝えます。これにより、マウスカーソルが「許可」を示すアイコンに変化し、ユーザーにドロップが可能であることを視覚的に伝えます。
- もしデータを受け入れたくない場合は、event->ignore() を呼び出すか、何もせずに（デフォルトでignoreされるため）関数を終了します。この場合、マウスカーソルは「禁止」を示すアイコンになります。
スクロール領域の特性: QAbstractScrollArea はスクロール領域であるため、dragEnterEvent() が発生した際、必要に応じてスクロールバーの状態を更新したり、ビューポートの表示を調整したりするロジックを追加することも考えられます。ただし、dragEnterEvent() の時点ではまだドロップは行われていないため、主に受け入れ可否の判断に集中します。

`QWidget` との関連

QAbstractScrollArea は QWidget を継承しており、QWidget にも dragEnterEvent() が存在します。QAbstractScrollArea は、そのビューポート（実際のスクロールされる内容が表示される部分）に対して発生したドラッグ＆ドロップイベントを、便利なように自身の dragEnterEvent() にマッピングして提供しています。したがって、QAbstractScrollArea を継承したクラスでドラッグ＆ドロップを処理したい場合は、この dragEnterEvent() をオーバーライドするのが一般的です。

要約

QAbstractScrollArea はスクロール可能な領域を提供するウィジェットであり、ドラッグ＆ドロップ機能を実装する際に非常に便利です。しかし、その特性上、一般的なQWidgetとは異なる考慮事項があり、以下のような問題に直面することがあります。

dragEnterEvent がまったく呼び出されない

原因:

event->acceptProposedAction() の呼び出し漏れ: dragEnterEvent内でevent->acceptProposedAction()を呼び出さないと、Qtはドラッグ操作を拒否したとみなし、それ以降のdragMoveEventやdropEventは発生しません。
MIMEタイプが一致しない: ドラッグされているデータが、dragEnterEvent内でevent->mimeData()->hasFormat()でチェックしているMIMEタイプと一致しない場合、イベントは無視されます。
イベントフィルターの問題: 複数のウィジェットが階層的に配置されている場合、イベントが目的のウィジェットに到達する前に親ウィジェットや子ウィジェットで処理（または無視）されてしまうことがあります。特にQAbstractScrollAreaの場合、実際の表示領域であるviewport()ウィジェットでイベントが発生することが多いです。
setAcceptDrops(true) の設定漏れ: ウィジェットがドロップを受け入れるように設定されていない場合、ドラッグ＆ドロップイベントは発生しません。

トラブルシューティング:

event->acceptProposedAction() の呼び出し: dragEnterEventの最後に、適切な条件（例えば、受け入れ可能なMIMEタイプの場合）でevent->acceptProposedAction(); を呼び出していることを確認します。
MIMEタイプの確認: ドラッグ元で設定しているMIMEタイプ（例: text/plain）と、dragEnterEvent内でチェックしているMIMEタイプが完全に一致しているかを確認します。
デバッグ出力の追加: dragEnterEventの先頭にqDebug()などを挿入し、イベントが実際に呼び出されているかを確認します。
viewport() の設定を確認: QAbstractScrollAreaのドラッグ＆ドロップは、通常、そのviewport()に対して行われます。viewport()に対してsetAcceptDrops(true)を設定する必要がある場合があります。例えば、viewport()->setAcceptDrops(true); のようにします。
setAcceptDrops(true) を確認: QAbstractScrollAreaを継承したクラスのコンストラクタで、setAcceptDrops(true); を呼び出していることを確認します。

// 例: dragEnterEvent の基本的な実装
void MyScrollArea::dragEnterEvent(QDragEnterEvent *event)
{
    qDebug() << "dragEnterEvent called.";
    if (event->mimeData()->hasFormat("application/my-custom-data")) {
        event->acceptProposedAction(); // この行が重要！
    } else {
        event->ignore();
    }
}

ドロップ時にオートスクロールしない

原因: QAbstractScrollAreaは、デフォルトではドラッグ中にマウスカーソルがスクロール領域の端に達しても自動的にスクロールしません。この機能は手動で実装する必要があります。

トラブルシューティング:

QTimer を利用したオートスクロール: スムーズなオートスクロールを実現するために、dragMoveEventでQTimerを開始/停止し、タイマーが発火するたびに少量ずつスクロールさせる方法がよく用いられます。
dragMoveEvent をオーバーライド: dragMoveEventをオーバーライドし、現在のマウスカーソル位置がスクロールエリアの端に近い場合に、verticalScrollBar()またはhorizontalScrollBar()のsetValue()を呼び出してスクロール位置を調整するロジックを追加します。

// 例: オートスクロールの実装 (概念的なコード)
void MyScrollArea::dragMoveEvent(QDragMoveEvent *event)
{
    if (event->mimeData()->hasFormat("application/my-custom-data")) {
        event->acceptProposedAction();

        // オートスクロールのロジック
        QRect viewportRect = viewport()->rect();
        QPoint pos = event->pos(); // QAbstractScrollArea::event() の場合

        int scrollSpeed = 10; // スクロール速度

        if (pos.y() < viewportRect.top() + 20) { // 上端に近づいた場合
            verticalScrollBar()->setValue(verticalScrollBar()->value() - scrollSpeed);
        } else if (pos.y() > viewportRect.bottom() - 20) { // 下端に近づいた場合
            verticalScrollBar()->setValue(verticalScrollBar()->value() + scrollSpeed);
        }
        // 水平方向も同様に処理
    } else {
        event->ignore();
    }
}

実際には、QTimerを使ってより滑らかなスクロールを実現するのが一般的です。

ドラッグ＆ドロップが不安定、時々動作しない

原因:

座標系のずれ: QAbstractScrollAreaと内部のウィジェットとの間で座標系の変換を誤ると、ドロップ位置の計算などが正しく行われないことがあります。
イベント伝播の問題: QAbstractScrollArea内に多くの複雑なウィジェットが配置されている場合、ドラッグイベントが意図しない子ウィジェットによって処理されたり、途中で無視されたりすることがあります。

トラブルシューティング:

座標変換の確認: mapToGlobal(), mapFromGlobal(), mapToParent(), mapFromParent()などの関数を使用して、イベントの座標が正しいウィジェットの座標系に変換されているかを確認します。特にdropEventでドロップ位置を特定する際に重要です。
イベントフィルターの使用: 複雑なウィジェット階層を持つ場合、installEventFilter()を使用してQAbstractScrollAreaまたはそのviewport()にイベントフィルターを設定し、そこでドラッグイベントを統一的に処理することを検討します。これにより、子ウィジェットでの意図しないイベント処理を防ぐことができます。

クラッシュまたは予期せぬ動作

原因:

メモリ管理の問題: ドラッグ＆ドロップでオブジェクトの所有権が移動する場合（例えば、Qt::MoveAction）、メモリの二重解放や解放漏れが発生することがあります。
無効なデータアクセス: event->mimeData()から取得したデータがnullであるか、期待するMIMEタイプではないにもかかわらず、そのデータを読み取ろうとした場合にクラッシュすることがあります。

トラブルシューティング:

アクションの確認と所有権: Qt::CopyAction, Qt::MoveAction, Qt::LinkActionなど、ドロップアクションによってデータの扱いが変わることを理解し、特にMoveActionの場合は元のデータを適切に削除するなど、所有権の移転を正しく処理します。
NullチェックとMIMEタイプチェックの徹底: event->mimeData()が有効か、そしてhasFormat()で適切なMIMEタイプを持っているかを常に確認してから、データにアクセスします。

ここでは、QAbstractScrollAreaを継承したシンプルなカスタムスクロールエリアを作成し、そこに特定のMIMEタイプ（例: "application/x-my-custom-data"）のデータがドラッグされたときに受け入れを許可する例を示します。

ヘッダーファイル (MyScrollArea.h)

#ifndef MYSCROLLAREA_H
#define MYSCROLLAREA_H

#include <QAbstractScrollArea>
#include <QDragEnterEvent> // QDragEnterEvent を使用するために必要
#include <QMimeData>     // QMimeData を使用するために必要
#include <QDebug>        // デバッグ出力用

class MyScrollArea : public QAbstractScrollArea
{
    Q_OBJECT

public:
    explicit MyScrollArea(QWidget *parent = nullptr);

protected:
    // ドラッグ操作がウィジェットの領域に進入したときに呼び出される
    void dragEnterEvent(QDragEnterEvent *event) override;

    // ドラッグ操作がウィジェットの領域内で移動したときに呼び出される
    void dragMoveEvent(QDragMoveEvent *event) override;

    // ドラッグ操作がウィジェットの領域を離れたときに呼び出される
    void dragLeaveEvent(QDragLeaveEvent *event) override;

    // ドロップ操作が行われたときに呼び出される
    void dropEvent(QDropEvent *event) override;

private:
    // このカスタムスクロールエリアに表示するコンテンツ（例: QWidget）
    QWidget *contentWidget;
};

#endif // MYSCROLLAREA_H

ソースファイル (MyScrollArea.cpp)

#include "MyScrollArea.h"
#include <QLabel> // 例としてコンテンツにQLabelを使用

MyScrollArea::MyScrollArea(QWidget *parent)
    : QAbstractScrollArea(parent)
{
    // ドロップイベントを受け入れるように設定
    // QAbstractScrollAreaの場合、viewport()に対して設定することも多い
    // setAcceptDrops(true); // こちらはQAbstractScrollArea自身がドロップを受け入れる場合
    viewport()->setAcceptDrops(true); // 通常はviewportがコンテンツを表示するため、viewportに設定

    // スクロールエリアに表示するコンテンツを設定
    contentWidget = new QLabel("ここにドラッグ＆ドロップしてください。\n\n"
                               "カスタムデータをドロップすると、\n"
                               "このラベルのテキストが変わります。", this);
    contentWidget->setAlignment(Qt::AlignCenter);
    contentWidget->setMinimumSize(400, 300); // 広い領域を確保
    setWidget(contentWidget); // QScrollAreaのようにコンテンツを設定
}

// dragEnterEvent の実装
void MyScrollArea::dragEnterEvent(QDragEnterEvent *event)
{
    qDebug() << "dragEnterEvent called.";

    // ドラッグされているデータがカスタムMIMEタイプを持っているか確認
    // ここでは "application/x-my-custom-data" というMIMEタイプを想定
    if (event->mimeData()->hasFormat("application/x-my-custom-data")) {
        qDebug() << "Custom data format detected.";
        // ドロップアクションとしてコピーを許可
        event->acceptProposedAction();
    } else {
        qDebug() << "Unsupported data format.";
        // サポートされていないMIMEタイプの場合はイベントを無視
        event->ignore();
    }
}

// dragMoveEvent の実装
void MyScrollArea::dragMoveEvent(QDragMoveEvent *event)
{
    qDebug() << "dragMoveEvent called.";
    // dragEnterEvent で acceptProposedAction() を呼び出していれば、
    // ここでも同じMIMEタイプをチェックし、acceptProposedAction() を呼び出す必要があります。
    // そうしないと、ドロップが許可されません。
    if (event->mimeData()->hasFormat("application/x-my-custom-data")) {
        event->acceptProposedAction();
    } else {
        event->ignore();
    }

    // オートスクロールのロジックをここに追加することができます。
    // 例えば、マウスカーソルがスクロールエリアの端に近づいたら自動でスクロールするなど。
    // 例:
    // int margin = 20;
    // if (event->pos().y() < margin) {
    //     verticalScrollBar()->setValue(verticalScrollBar()->value() - 10);
    // } else if (event->pos().y() > viewport()->height() - margin) {
    //     verticalScrollBar()->setValue(verticalScrollBar()->value() + 10);
    // }
}

// dragLeaveEvent の実装
void MyScrollArea::dragLeaveEvent(QDragLeaveEvent *event)
{
    qDebug() << "dragLeaveEvent called.";
    // 特に何もする必要がない場合が多いですが、
    // ドラッグ中の視覚的なフィードバック（ハイライトなど）をリセットするのに使えます。
    event->accept(); // イベント処理を終了
}

// dropEvent の実装
void MyScrollArea::dropEvent(QDropEvent *event)
{
    qDebug() << "dropEvent called.";
    if (event->mimeData()->hasFormat("application/x-my-custom-data")) {
        // ドロップされたカスタムデータを受け取る
        QByteArray data = event->mimeData()->data("application/x-my-custom-data");
        QString droppedText = QString::fromUtf8(data);
        qDebug() << "Dropped custom data: " << droppedText;

        // コンテンツのQLabelのテキストを更新
        QLabel *label = qobject_cast<QLabel*>(contentWidget);
        if (label) {
            label->setText("ドロップされたデータ: " + droppedText);
        }

        event->acceptProposedAction(); // ドロップを受け入れる
    } else {
        event->ignore();
    }
}

// QScrollArea の setWidget() に似た機能を提供
void MyScrollArea::setWidget(QWidget *widget)
{
    if (contentWidget) {
        contentWidget->setParent(nullptr); // 既存のコンテンツを親から外す
    }
    contentWidget = widget;
    if (contentWidget) {
        // ビューポートを親として設定
        contentWidget->setParent(viewport());
        // コンテンツのサイズに合わせてスクロールバーの範囲を更新
        QSize contentSize = contentWidget->sizeHint();
        verticalScrollBar()->setRange(0, contentSize.height() - viewport()->height());
        horizontalScrollBar()->setRange(0, contentSize.width() - viewport()->width());
    }
}

メインウィンドウ (MainWindow.h, MainWindow.cpp) と main.cpp

MainWindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QVBoxLayout>
#include "MyScrollArea.h" // 作成したカスタムスクロールエリア

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    MyScrollArea *myScrollArea;
};

#endif // MAINWINDOW_H

MainWindow.cpp

#include "MainWindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle("QAbstractScrollArea Drag & Drop Example");

    QWidget *centralWidget = new QWidget(this);
    setCentralWidget(centralWidget);

    QVBoxLayout *layout = new QVBoxLayout(centralWidget);

    myScrollArea = new MyScrollArea(this);
    layout->addWidget(myScrollArea);

    // ドロップ元として使うためのダミーボタン
    QPushButton *dragSourceButton = new QPushButton("これをドラッグしてください", this);
    layout->addWidget(dragSourceButton);

    // ドラッグ開始イベントを処理する lambda
    connect(dragSourceButton, &QPushButton::pressed, [this, dragSourceButton]() {
        QMimeData *mimeData = new QMimeData();
        // カスタムMIMEタイプでデータを設定
        mimeData->setData("application/x-my-custom-data", "Hello from Drag Source!");

        QDrag *drag = new QDrag(dragSourceButton);
        drag->setMimeData(mimeData);
        drag->setPixmap(dragSourceButton->grab()); // ドラッグ中の表示用ピクスマップ
        drag->exec(Qt::CopyAction | Qt::MoveAction); // コピーまたは移動アクションを許可
    });

    resize(600, 500);
}

MainWindow::~MainWindow()
{
}

#include <QApplication>
#include "MainWindow.h"

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

    MainWindow w;
    w.show();

    return a.exec();
}

実行方法

上記のコードをそれぞれ .h と .cpp ファイルとして保存します（例: MyScrollArea.h, MyScrollArea.cpp, MainWindow.h, MainWindow.cpp, main.cpp）。
Qt Creator を使用している場合、新しいQt Widgets Applicationプロジェクトを作成し、これらのファイルをプロジェクトに追加します。
.pro ファイルに QT += widgets が含まれていることを確認します。
プロジェクトをビルドして実行します。

MainWindow クラス:
- アプリケーションのメインウィンドウです。
- MyScrollArea のインスタンスを作成し、セントラルウィジェットに配置しています。
- ドラッグ元として機能するQPushButtonを作成し、そのpressedシグナルにラムダ関数を接続しています。
- ラムダ関数内で、QMimeDataオブジェクトを作成し、setData()を使ってカスタムMIMEタイプ（"application/x-my-custom-data"）と関連するデータを設定しています。
- QDragオブジェクトを作成し、setMimeData()でMIMEデータを設定し、exec()でドラッグ操作を開始しています。
MyScrollArea クラス:
- QAbstractScrollAreaを継承しています。
- コンストラクタでviewport()->setAcceptDrops(true);を呼び出すことで、このスクロールエリアのビューポートがドラッグ＆ドロップイベントを受け入れるように設定しています。QAbstractScrollAreaの場合、直接setAcceptDrops(true)を呼び出すのではなく、viewport()に対して呼び出すのが一般的です。
- setWidget()関数は、QScrollAreaのように内部に任意のウィジェットを配置できるようにするためのヘルパー関数です。このウィジェットがスクロール対象のコンテンツになります。
- dragEnterEvent(QDragEnterEvent *event) override;:
  - ドラッグ操作がこのウィジェットの領域に進入したときに呼び出されます。
  - event->mimeData()->hasFormat("application/x-my-custom-data") を使用して、ドラッグされているデータが特定のMIMEタイプ（ここでは "application/x-my-custom-data"）を持っているかを確認しています。
  - もしMIMEタイプが一致すれば、event->acceptProposedAction(); を呼び出します。これにより、Qtはドロップが可能であることを示唆し、マウスカーソルが適切なドロップアイコンに変化します。この呼び出しがないと、その後のdragMoveEventやdropEventは発生しません。
  - 一致しない場合はevent->ignore();を呼び出し、ドロップを拒否します。
- dragMoveEvent(QDragMoveEvent *event) override;:
  - ドラッグ操作がこのウィジェットの領域内で移動している間に継続的に呼び出されます。
  - ここでもdragEnterEventと同様にMIMEタイプをチェックし、event->acceptProposedAction()を呼び出すことで、ドロップが継続して可能であることをQtに伝えます。
  - オートスクロール機能などを実装する場合は、このイベント内でマウスの位置に基づいてスクロールバーの値を変更するロジックを追加します。
- dragLeaveEvent(QDragLeaveEvent *event) override;:
  - ドラッグ操作がこのウィジェットの領域を離れたときに呼び出されます。
  - ドラッグ中の視覚的なフィードバック（例えば、ドロップ可能領域のハイライトなど）をリセットするのに利用できます。
- dropEvent(QDropEvent *event) override;:
  - ユーザーがドラッグ中のデータをこのウィジェットにドロップしたときに呼び出されます。
  - ここでもMIMEタイプを確認し、event->mimeData()->data("application/x-my-custom-data")を使って実際のデータを取得します。
  - 取得したデータを使って、アプリケーション固有の処理（例: QLabelのテキスト更新）を行います。
  - 処理が完了したらevent->acceptProposedAction();を呼び出し、ドロップが正常に処理されたことを示します。

QObject::eventFilter() を使用する

最も一般的な代替手段の一つがイベントフィルターです。これは、特定のウィジェットに送られるすべてのイベントを、そのウィジェットが処理する前に横取りして処理できる強力なメカニズムです。

メリット:

イベントの伝播制御: eventFilter()内でtrueを返すとイベントの伝播を停止できるため、下位のウィジェットがイベントを受け取らないように制御できます。
中央集約されたイベント処理: 複数のウィジェットやオブジェクトのイベントを一つのイベントフィルターオブジェクトで処理できるため、イベント処理のロジックを中央集約できます。
既存のクラスを変更せずにイベントを処理: 既存のQAbstractScrollArea（またはその派生クラス）を継承せずに、そのインスタンスにイベントフィルターを設定できます。これは、サードパーティのウィジェットや、すでに多くの機能を持ち、これ以上継承したくないウィジェットに対してドラッグ＆ドロップを追加したい場合に特に便利です。

デメリット:

dynamic_castの利用: イベントの種類を判別するためにQEventを適切なイベントクラス（例: QDragEnterEvent）にdynamic_castする必要があり、わずかなオーバーヘッドが生じます。
コードの分離: イベント処理のロジックがウィジェットのクラス定義から分離されるため、コードの可読性が低下する可能性があります。

実装例:

// MyEventFilter.h
#ifndef MYEVENTFILTER_H
#define MYEVENTFILTER_H

#include <QObject>
#include <QEvent>
#include <QDragEnterEvent>
#include <QMimeData>
#include <QDebug>

class MyEventFilter : public QObject
{
    Q_OBJECT
public:
    explicit MyEventFilter(QObject *parent = nullptr) : QObject(parent) {}

protected:
    bool eventFilter(QObject *watched, QEvent *event) override
    {
        if (event->type() == QEvent::DragEnter) {
            QDragEnterEvent *dragEnterEvent = static_cast<QDragEnterEvent*>(event);
            qDebug() << "Event filter: DragEnter event on" << watched->objectName();

            if (dragEnterEvent->mimeData()->hasFormat("application/x-my-custom-data")) {
                qDebug() << "Event filter: Custom data format detected. Accepting.";
                dragEnterEvent->acceptProposedAction();
                return true; // イベント処理をここで終了し、ウィジェットに伝播させない
            } else {
                qDebug() << "Event filter: Unsupported format. Ignoring.";
                dragEnterEvent->ignore();
                return true; // イベント処理をここで終了し、ウィジェットに伝播させない
            }
        }
        // 他のドラッグ＆ドロップイベントもここで処理可能
        else if (event->type() == QEvent::DragMove) {
            QDragMoveEvent *dragMoveEvent = static_cast<QDragMoveEvent*>(event);
            if (dragMoveEvent->mimeData()->hasFormat("application/x-my-custom-data")) {
                dragMoveEvent->acceptProposedAction();
                return true;
            } else {
                dragMoveEvent->ignore();
                return true;
            }
        }
        else if (event->type() == QEvent::Drop) {
            QDropEvent *dropEvent = static_cast<QDropEvent*>(event);
            if (dropEvent->mimeData()->hasFormat("application/x-my-custom-data")) {
                QString droppedText = QString::fromUtf8(dropEvent->mimeData()->data("application/x-my-custom-data"));
                qDebug() << "Event filter: Dropped custom data: " << droppedText;
                // ここで watched オブジェクト（例: QAbstractScrollArea）にデータを反映するロジック
                // 例: qobject_cast<QLabel*>(watched)->setText("Dropped: " + droppedText);
                dropEvent->acceptProposedAction();
                return true;
            } else {
                dropEvent->ignore();
                return true;
            }
        }

        // それ以外のイベントは通常通り処理させる
        return QObject::eventFilter(watched, event);
    }
};

#endif // MYEVENTFILTER_H

使用方法 (メインウィンドウなど)

#include "MyScrollArea.h" // MyScrollAreaクラスも再利用する場合
#include "MyEventFilter.h" // 新しいイベントフィルタークラス

// ... (MyScrollAreaのインスタンス化)
MyScrollArea *myScrollArea = new MyScrollArea(this);
// myScrollArea->viewport()にイベントフィルターをインストール
myScrollArea->viewport()->installEventFilter(new MyEventFilter(myScrollArea->viewport())); // parentを設定することでメモリ管理をQtに任せる
// setAcceptDrops(true) は必要
myScrollArea->viewport()->setAcceptDrops(true);

QAbstractItemView クラスの利用 (モデル/ビューアーキテクチャ)

QAbstractScrollAreaは汎用的なスクロールエリアですが、アイテムリストやテーブル、ツリーなどのデータを表示し、それらのアイテムに対するドラッグ＆ドロップを行いたい場合は、Qtのモデル/ビュープログラミングを利用するのが最も適切で強力な方法です。

QAbstractItemView（およびその派生クラスであるQListView、QTableView、QTreeView）は、内部でQAbstractScrollAreaを継承しており、ドラッグ＆ドロップ機能をより抽象化されたレベルで提供します。

複雑なデータのドラッグ＆ドロップを容易に: 項目間の移動、コピー、親子関係の変更など、複雑なドラッグ＆ドロップ操作をモデルのレベルで処理できます。
MIMEデータとアイテムの自動変換: QAbstractItemModel::mimeTypes()やdropMimeData()などを実装することで、モデルとビューが連携してデータのシリアライズ・デシリアライズを行います。
組み込みのドラッグ＆ドロップ機能: setDragDropMode()などのメソッドで簡単にドラッグ＆ドロップの挙動（内部移動、コピー、ドロップのみなど）を設定できます。
データと表示の分離: データ（モデル）と表示（ビュー）が分離されるため、大規模なデータや複雑なデータ構造を効率的に管理できます。

モデルの実装: カスタムデータ型を扱う場合、QAbstractItemModelを継承した独自のモデルクラスを実装する必要があります。
学習コスト: モデル/ビューアーキテクチャは学習曲線があり、シンプルなドラッグ＆ドロップには過剰な場合もあります。

実装のポイント:

モデル側でmimeTypes()、dropMimeData()、そして必要に応じてsupportedDropActions()、supportedDragActions()をオーバーライドする。
モデル側でflags()関数をオーバーライドし、ドラッグ可能なアイテムにはQt::ItemIsDragEnabled、ドロップ可能な場所（またはアイテム）にはQt::ItemIsDropEnabledフラグを返す。
QAbstractItemView::setDragDropMode(QAbstractItemView::DragDrop) などでドロップモードを設定。

例: `QListView` での基本的なドラッグ＆ドロップ設定

#include <QApplication>
#include <QMainWindow>
#include <QListView>
#include <QStringListModel>
#include <QVBoxLayout>

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

    QMainWindow window;
    QWidget *centralWidget = new QWidget(&window);
    window.setCentralWidget(centralWidget);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);

    QListView *listView = new QListView(centralWidget);
    QStringListModel *model = new QStringListModel(listView);
    QStringList data;
    data << "Item 1" << "Item 2" << "Item 3";
    model->setStringList(data);
    listView->setModel(model);

    // ドラッグ＆ドロップモードを設定
    listView->setDragDropMode(QAbstractItemView::DragDrop);
    listView->setDropIndicatorShown(true); // ドロップインジケータを表示
    listView->setDefaultDropAction(Qt::MoveAction); // デフォルトのアクションを移動に設定

    // モデル側でもフラグを設定する必要がある
    // QAbstractStringListModelはデフォルトでドラッグ＆ドロップに対応しているため、
    // 基本的なリストの並び替えはこれだけで可能

    layout->addWidget(listView);

    window.resize(300, 200);
    window.show();

    return a.exec();
}

この例では、QListViewとQStringListModelの組み合わせにより、コードをほとんど書かずにリストアイテムのドラッグ＆ドロップによる並び替えが実現できます。

QAbstractScrollAreaには仮想関数void viewportEvent(QEvent *event) override;が存在します。これは、QAbstractScrollAreaのビューポートに送信されるすべてのイベントを処理するための汎用的なイベントハンドラです。dragEnterEvent()のような個別のイベントハンドラは、実際にはこのviewportEvent()から適切なイベントタイプを検出して呼び出されています。

継承によるカスタマイズ: QAbstractScrollAreaのサブクラス内でviewportEvent()をオーバーライドすることで、そのビューポートのイベント処理を細かく制御できます。
全てのビューポートイベントを一箇所で処理: dragEnterEventだけでなく、mousePressEventやresizeEventなど、ビューポートで発生するあらゆるイベントを統一的に処理できます。

複雑さの増加: 複数のイベントタイプを処理する場合、switch文などでロジックが複雑になりがちです。
イベントタイプの判別が必須: QEvent::type()を使ってイベントの種類を自分で判別し、適切な型にキャストする必要があります。これはeventFilter()に似ていますが、クラス内部での処理になります。

実装例 (dragEnterEvent 部分):

// MyScrollArea.h (一部抜粋)
protected:
    bool viewportEvent(QEvent *event) override;

// MyScrollArea.cpp (一部抜粋)
bool MyScrollArea::viewportEvent(QEvent *event)
{
    if (event->type() == QEvent::DragEnter) {
        QDragEnterEvent *dragEnterEvent = static_cast<QDragEnterEvent*>(event);
        qDebug() << "viewportEvent: DragEnter called.";
        if (dragEnterEvent->mimeData()->hasFormat("application/x-my-custom-data")) {
            dragEnterEvent->acceptProposedAction();
            return true; // イベントを処理済みとしてマーク
        }
    }
    // その他のイベントタイプを処理
    // ...

    // 未処理のイベントは基底クラスに任せる
    return QAbstractScrollArea::viewportEvent(event);
}

viewportEvent(): QAbstractScrollAreaのビューポートのすべてのイベントを細かく制御したい場合に利用しますが、通常は個別のイベントハンドラで十分です。
QAbstractItemView (モデル/ビュー): リスト、テーブル、ツリーなどの構造化されたデータを扱う場合、最も推奨されるアプローチです。データ管理と表示が分離され、高度なドラッグ＆ドロップ機能が組み込まれています。
QObject::eventFilter(): 既存のウィジェットの動作を変更したい場合や、複数のウィジェットのイベントを中央で管理したい場合に強力な代替手段となります。特にQAbstractScrollAreaの子ウィジェットに対するイベントを親で処理したい場合に有効です。
dragEnterEvent()の直接オーバーライド: 最も直接的で一般的な方法。ウィジェット自身のドラッグ＆ドロップ処理を実装する場合に推奨されます。

Qtドラッグ&ドロップ入門: dragEnterEvent()でのMIMEタイプ判定とイベント処理

役割

実装と処理

QWidget との関連

要約

dragEnterEvent がまったく呼び出されない

ドロップ時にオートスクロールしない

ドラッグ＆ドロップが不安定、時々動作しない

クラッシュまたは予期せぬ動作

ヘッダーファイル (MyScrollArea.h)

ソースファイル (MyScrollArea.cpp)

メインウィンドウ (MainWindow.h, MainWindow.cpp) と main.cpp

実行方法

QObject::eventFilter() を使用する

メリット:

デメリット:

実装例:

QAbstractItemView クラスの利用 (モデル/ビューアーキテクチャ)

実装のポイント:

例: QListView での基本的なドラッグ＆ドロップ設定

実装例 (dragEnterEvent 部分):

`QWidget` との関連

例: `QListView` での基本的なドラッグ＆ドロップ設定