Qtマウスイベント処理の選択肢：mousePressEvent以外の代替手法を徹底解説

2025-05-27

`void QAbstractScrollArea::mousePressEvent(QMouseEvent *event)` とは

これは、QtフレームワークのQAbstractScrollAreaクラスに属する**仮想関数（virtual function）**です。

QAbstractScrollAreaは、スクロール可能な領域（例えば、大きな画像を表示したり、たくさんのウィジェットを配置したりする際に、表示しきれない部分をスクロールして見せるための領域）を抽象化した基底クラスです。このクラスを継承した具体的なウィジェット（例: QScrollArea, QTextEdit, QGraphicsViewなど）は、内部にビューポート（表示領域）を持ち、そのビューポート内のコンテンツをスクロールさせることができます。

mousePressEvent(QMouseEvent *event)関数は、その名の通り、マウスのボタンが押されたときに発生するイベントを処理するためのものです。

どのような時に呼び出されるか

ユーザーがQAbstractScrollAreaを継承したウィジェット（またはその子ウィジェット）の可視領域（ビューポート）内でマウスボタンを押したときに、この関数がQtのイベントシステムによって自動的に呼び出されます。

引数 `QMouseEvent *event` について

この関数には、QMouseEvent型のポインタeventが引数として渡されます。QMouseEventオブジェクトには、マウスイベントに関する詳細な情報が含まれています。具体的には、以下のような情報を取得できます。

修飾キー（Modifier keys）の状態 (event->modifiers())
ShiftキーやCtrlキーなどが同時に押されていたか。
押された時点のマウスカーソルの座標 (event->pos())
イベントが発生したウィジェット内の相対座標。
どのボタンが押されたか (event->button())
Qt::LeftButton (左クリック), Qt::RightButton (右クリック), Qt::MidButton (中央クリック) など。

通常、QAbstractScrollAreaを継承したカスタムウィジェットを作成する際、ユーザーがマウスで何らかの操作（例えば、ドラッグによるスクロール、特定の要素の選択など）を行えるようにしたい場合に、このmousePressEvent関数をオーバーライド（再実装）します。

オーバーライドした関数内で、QMouseEventオブジェクトから必要な情報を取得し、それに基づいてカスタムの動作を実装します。

例

#include <QAbstractScrollArea>
#include <QMouseEvent>
#include <QDebug>

class MyCustomScrollArea : public QAbstractScrollArea
{
public:
    MyCustomScrollArea(QWidget *parent = nullptr) : QAbstractScrollArea(parent) {}

protected:
    void mousePressEvent(QMouseEvent *event) override
    {
        // 左ボタンが押された場合のみ処理を行う
        if (event->button() == Qt::LeftButton) {
            qDebug() << "左ボタンが押されました。座標: " << event->pos();

            // ここにカスタムの処理を記述
            // 例: ドラッグ開始位置を記憶する
            // m_lastMousePos = event->pos();
        }

        // 基底クラスのmousePressEventを呼び出すことで、
        // デフォルトのスクロール動作などが引き続き機能するようにする
        QAbstractScrollArea::mousePressEvent(event);
    }
};

QEvent::ignore() と QEvent::accept()
QMouseEventはQEventを継承しており、イベントを処理したかどうかをevent->accept() (処理した) または event->ignore() (処理しない) で示すことができます。デフォルトではイベントはaccept()されています。ignore()を設定すると、イベントは親ウィジェットに伝播します。
イベント伝播
mousePressEventをオーバーライドした場合、通常は基底クラスのmousePressEventも呼び出すことを推奨します。そうしないと、Qtが提供するデフォルトのスクロール動作などが失われる可能性があります。QAbstractScrollArea::mousePressEvent(event);のように呼び出します。
仮想関数
virtualキーワードがついており、派生クラスで自由に再実装できます。

この関数は、マウスイベント処理の根幹に関わるため、正しく理解していないと意図しない動作を引き起こすことがあります。

イベントがまったく発生しない/検出されない

考えられる原因

異なるスレッドでGUI操作を行っている
- QtのGUI操作はメインスレッドで行う必要があります。別スレッドからGUIを操作しようとすると、イベントが正しく処理されないことがあります。
ウィジェットのサイズが0になっている
- ウィジェットのサイズがQSize(0,0)になっている場合、クリックできる領域がないためイベントが発生しません。
ウィジェットがマウスイベントを受け付けるように設定されていない
- QWidget::setMouseTracking(true)を設定していない場合、マウスボタンが押されていない状態でのmouseMoveEventは発生しませんが、mousePressEventは通常発生します。ただし、何らかの理由でイベントループが正しく機能していない可能性もゼロではありません。
ウィジェットが可視状態でない、または有効でない
- setVisible(false)やsetEnabled(false)が設定されているウィジェットは、マウスイベントを受け付けません。
イベントの伝播が停止している
- 親ウィジェットや他の子ウィジェットがイベントをaccept()してしまっている場合、そのイベントはそれ以上の子ウィジェットには伝播されません。特に、カスタムウィジェットが別のウィジェット（ボタンなど）の上にある場合、そのボタンがクリックイベントを消費してしまいます。
- イベントフィルターがイベントを消費している可能性もあります。

トラブルシューティング

親ウィジェットのイベントハンドラを確認
親ウィジェットがmousePressEventをオーバーライドしていて、event->accept()を明示的に呼び出している場合、子ウィジェットにはイベントが伝わりません。
ウィジェットのプロパティ確認
isVisible(), isEnabled(), size()などの値をデバッガで確認します。
イベントフィルターの確認
アプリケーション全体や特定のウィジェットにイベントフィルターがインストールされていないか確認します。
qDebug() を使用したデバッグ
mousePressEventの先頭にqDebug() << "Mouse press event occurred";などを挿入し、実行時にメッセージが表示されるか確認します。

座標が期待通りでない

考えられる原因

スクロールオフセットの考慮漏れ
QAbstractScrollArea内で表示されているコンテンツは、スクロールによって表示位置が変わります。event->pos()はスクロールエリアのビューポート内の座標ですが、その座標をスクロールエリア内のコンテンツ全体の座標に変換する必要があります。
座標系の混同
event->pos()はイベントを受け取ったウィジェットのローカル座標系（左上が(0,0)）ですが、event->globalPos()はスクリーン全体のグローバル座標系です。これらの混同により、計算が狂うことがあります。

トラブルシューティング

スクロールオフセットの適用
- QAbstractScrollAreaの場合、スクロールによって表示されているコンテンツのオフセットを考慮する必要があります。
- 一般的には、水平スクロールバーと垂直スクロールバーの値をevent->pos()に加算することで、コンテンツ全体の座標に変換できます。
```
QPoint contentPos = event->pos() + QPoint(horizontalScrollBar()->value(), verticalScrollBar()->value());
// contentPos を使用してコンテンツ内の要素を特定
```
- または、QAbstractScrollArea::viewport()->mapToParent(event->pos())や、ビューポート内のウィジェットからmapToGlobal()、mapFromGlobal()などを適切に使用します。mapToParent()やmapFromParent()、mapToGlobal()、mapFromGlobal()などの変換関数を理解し、適切に利用することが重要です。
event->pos() と event->globalPos() の使い分け
- ウィジェット内での相対的な位置が必要な場合はevent->pos()を使用します。
- スクリーン上の絶対的な位置が必要な場合はevent->globalPos()を使用します。

イベントが複数回発生する、または意図せず連鎖する

考えられる原因

基底クラスのイベントハンドラを呼び出していない/間違って呼び出している
- カスタムのmousePressEventをオーバーライドした場合、通常は最後に基底クラスのQAbstractScrollArea::mousePressEvent(event);を呼び出すべきです。これを呼び出さないと、スクロールエリアのデフォルトの動作（例えば、マウスドラッグによるスクロールなど）が機能しなくなります。
- 逆に、意図しないタイミングで基底クラスのイベントを呼び出したり、イベント処理の途中で呼び出したりすると、予期せぬ動作を招くことがあります。
event->accept() / event->ignore() の不適切な使用
- event->accept()を呼び出すと、そのイベントはそのウィジェットで処理され、それ以上親ウィジェットには伝播しません。
- event->ignore()を呼び出すと、イベントは処理されずに親ウィジェットに伝播します。
- もし意図せずevent->ignore()を呼び出し続けてしまうと、親ウィジェットも同じイベントを処理してしまい、二重処理になる可能性があります。

トラブルシューティング

基底クラスの呼び出し位置

カスタム処理が完了した後で、QAbstractScrollArea::mousePressEvent(event);を呼び出すようにします。

例:

void MyCustomScrollArea::mousePressEvent(QMouseEvent *event)
{
    // カスタム処理
    // 例: 特定の領域をクリックした場合の処理
    if (event->button() == Qt::LeftButton && someCondition) {
        // ...
        event->accept(); // このイベントはここで処理済み
        return; // 基底クラスには伝えない
    }

    // ここに到達した場合、カスタム処理では完全に処理されなかったため、
    // 基底クラスのデフォルト動作に任せる
    QAbstractScrollArea::mousePressEvent(event);
}

event->accept() / event->ignore() の確認
- イベントを完全に処理し、それ以上伝播させたくない場合は、event->accept()を明示的に呼び出すか、何もせずに（デフォルトでacceptされているため）関数を終了します。
- イベントを処理せず、親に伝播させたい場合はevent->ignore()を呼び出します。
- デバッグ出力で、どのウィジェットがイベントを受け取り、acceptまたはignoreしているかを追跡すると良いでしょう。

mouseMoveEventと連携したドラッグ操作がうまくいかない

考えられる原因

状態管理の欠如
- ドラッグ操作を実装する場合、mousePressEventでドラッグ開始位置を記憶し、mouseMoveEventでその位置からの差分を計算し、mouseReleaseEventでドラッグ終了の処理を行うなど、状態（フラグや開始位置など）を管理する必要があります。
マウスの捕捉（Mouse Grab）の理解不足
- Qtでは、マウスボタンがウィジェット内で押されると、そのウィジェットがマウスを「グラブ」します。つまり、マウスボタンが離されるまで、そのウィジェットがすべてのマウスイベントを受け取ります（たとえカーソルがウィジェットの範囲外に出ても）。
- この挙動を理解していないと、ドラッグ中にカーソルがウィジェット外に出た際にイベントが停止したように感じることがあります。
setMouseTracking(true)が設定されていない
- mouseMoveEventは、通常マウスボタンが押されている間のみ発生します。マウスボタンが押されていない状態でもマウス移動イベントを受け取りたい場合は、setMouseTracking(true)をウィジェットに設定する必要があります。ただし、これはmousePressEventに直接関係しません。

トラブルシューティング

setMouseTracking(true)の必要性の判断
- マウスボタンが押されていない状態でのカーソル追跡が必要な場合は設定します。通常、ドラッグ操作には不要です。
mouseReleaseEventでのフラグ解除
- mouseReleaseEventでm_isDragging = false;を設定します。
mouseMoveEventでの差分計算
- mouseMoveEvent内でm_isDraggingが真の場合に、event->pos() - m_lastMousePosなどで移動量を計算し、ウィジェットの位置や内容を更新します。
ドラッグ開始フラグと初期位置の記録
- mousePressEventでm_isDragging = true;とm_lastMousePos = event->pos();などを設定します。

子ウィジェット上でのクリックが親のQAbstractScrollAreaに伝わらない

考えられる原因

子ウィジェットがイベントを消費している
- 子ウィジェット（例: QPushButton, QLabelなど）は、デフォルトで自身に発生したマウスイベントを処理（accept()）します。そのため、その親であるQAbstractScrollAreaのmousePressEventにはイベントが伝わりません。

子ウィジェットではなく、QAbstractScrollAreaのviewport()に直接描画する
- もし子ウィジェットが純粋な表示目的であり、複雑なインタラクションが不要であれば、QAbstractScrollAreaのビューポートに直接QPainterを使用して描画し、クリック検出はQAbstractScrollAreaのmousePressEvent内で行うのが最も単純な方法です。
子ウィジェットをカスタムし、mousePressEvent内でevent->ignore()を呼び出す
- 子ウィジェットがカスタムクラスの場合、そのmousePressEvent内でevent->ignore()を呼び出すことで、親ウィジェットにイベントを伝播させることができます。ただし、子ウィジェットが元々持っているデフォルトのクリック動作（例: QPushButtonがclicked()シグナルを発する）も無効になる可能性があるため注意が必要です。
子ウィジェットにイベントフィルターをインストールする
- 親のQAbstractScrollAreaに、子ウィジェットのイベントを監視するイベントフィルターをインストールします。イベントフィルター内で、子ウィジェットに発生したマウスイベントを捕捉し、必要に応じてevent->ignore()を呼び出して親に伝播させたり、独自に処理したりします。
- parentWidget->installEventFilter(childWidget);
- イベントフィルター内でevent->type() == QEvent::MouseButtonPressをチェックし、処理を行います。

例1: 単純なクリックイベントの検出と座標表示

最も基本的な例として、QAbstractScrollAreaを継承したカスタムウィジェット内でマウスの左ボタンが押されたときに、その座標をデバッグ出力する例です。

// mycustomscrollarea.h
#ifndef MYCUSTOMSCROLLAREA_H
#define MYCUSTOMSCROLLAREA_H

#include <QAbstractScrollArea>
#include <QMouseEvent> // QMouseEventを使うために必要
#include <QDebug>      // qDebug()を使うために必要

class MyCustomScrollArea : public QAbstractScrollArea
{
    Q_OBJECT // シグナル/スロットを使用する場合に必要

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

protected:
    // mousePressEventをオーバーライド
    void mousePressEvent(QMouseEvent *event) override;
};

#endif // MYCUSTOMSCROLLAREA_H

// mycustomscrollarea.cpp
#include "mycustomscrollarea.h"

MyCustomScrollArea::MyCustomScrollArea(QWidget *parent)
    : QAbstractScrollArea(parent)
{
    // 必要に応じて、ビューポートに色を付けたりして可視化する
    // 例: setBackgroundColor(Qt::white); のようなものは直接ないため、
    // パレットを設定するか、paintEventをオーバーライドする
    viewport()->setBackgroundRole(QPalette::Light);
    viewport()->setAutoFillBackground(true);

    // テスト用のコンテンツを追加したい場合はここに記述
    // 例: QLabel *label = new QLabel("Scrollable Content", viewport());
    //      label->move(100, 100);
}

void MyCustomScrollArea::mousePressEvent(QMouseEvent *event)
{
    // マウスの左ボタンが押されたかどうかをチェック
    if (event->button() == Qt::LeftButton) {
        // イベントが発生したウィジェット内のローカル座標を取得
        QPoint localPos = event->pos();

        // スクリーン上のグローバル座標を取得
        QPoint globalPos = event->globalPos();

        qDebug() << "Mouse Left Button Pressed!";
        qDebug() << "  Local Position (relative to viewport): " << localPos;
        qDebug() << "  Global Position (on screen): " << globalPos;

        // ここに、左クリック時のカスタム処理を記述します。
        // 例: 特定のアイテムを選択状態にする、ドラッグ操作を開始する準備など
    }
    // マウスの右ボタンが押されたかどうかをチェック
    else if (event->button() == Qt::RightButton) {
        qDebug() << "Mouse Right Button Pressed!";
        // 右クリック時のカスタム処理
        // 例: コンテキストメニューを表示するなど
    }

    // 重要: 基底クラスのmousePressEventを呼び出すことで、
    // QAbstractScrollAreaが持つデフォルトのスクロール動作（例: ドラッグによるスクロール）
    // や、他のイベント処理が引き続き機能するようにします。
    // イベントを完全に処理してそれ以上伝播させたくない場合は、
    // この行をコメントアウトするか、event->accept()を呼び出した後にreturnします。
    QAbstractScrollArea::mousePressEvent(event);
}

使用例 (main.cpp または他のウィジェット内)

// main.cpp
#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include "mycustomscrollarea.h"

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

    QMainWindow window;
    window.setWindowTitle("Custom Scroll Area Example");
    window.resize(600, 400);

    MyCustomScrollArea *scrollArea = new MyCustomScrollArea(&window);
    // スクロール可能なコンテンツのサイズを大きく設定
    // 例: 500x500ピクセルの固定サイズとする (viewportSizeHint()などをオーバーライドすることも可能)
    // ここでは、ビューポートのサイズではなく、その中に表示されるコンテンツのサイズを想定
    // 通常は、QScrollArea::setWidget() でウィジェットを設定し、そのウィジェットのサイズがスクロール対象となる
    // 今回はQAbstractScrollAreaを直接継承しているため、コンテンツのサイズを明示的に指定する必要がある
    // または paintEvent で大きな領域を描画する
    
    // 単純な例として、固定サイズのコンテンツを仮定する
    scrollArea->setMinimumSize(400, 300); // 自身のサイズ

    // QAbstractScrollAreaは直接コンテンツを持たないため、
    // 通常はviewport()にカスタムのウィジェットをセットするか、
    // paintEventをオーバーライドして描画します。
    // 例では背景色を設定していますが、実際のコンテンツがないとスクロールバーは出ません。

    // スクロールバーのポリシーを設定
    scrollArea->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
    scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);

    // QAbstractScrollAreaのビューポートがコンテンツのサイズを知る必要がある
    // ここでは単純にviewportのサイズヒントを設定する
    // あるいは、paintEventで描画するコンテンツの総サイズを計算してvirtualSizeを設定する
    // 通常は、QScrollAreaを使うか、QGraphicsViewのようなより高レベルなクラスを使う
    
    // QAbstractScrollAreaのサブクラスでカスタム描画を行う場合、
    // 例えば、以下のようにコンテンツの仮想サイズを設定することが考えられます。
    // ただし、これだけではスクロールバーは表示されない。
    // スクロールバーは、viewportSizeHint()やscrollContentsBy()などを実装する必要がある。

    // 最も簡単なQAbstractScrollAreaの使用法は、
    // QScrollAreaのようにsetWidget()を呼び出すことだが、
    // QAbstractScrollAreaを直接継承している場合は、自分でビューポートの
    // paintEventとスクロールバーの動作を制御する必要がある。
    
    // 今回の例では、単にクリックイベントの検出に焦点を当てているため、
    // スクロール機能が完全に動作しなくても問題ないものとする。
    // 実際にスクロールさせたい場合は、QScrollAreaを使うか、
    // QAbstractScrollArea::scrollContentsBy()を実装する必要がある。

    QVBoxLayout *layout = new QVBoxLayout();
    layout->addWidget(scrollArea);

    QWidget *centralWidget = new QWidget();
    centralWidget->setLayout(layout);
    window.setCentralWidget(centralWidget);

    window.show();

    return a.exec();
}

例2: ドラッグによる矩形選択の開始

mousePressEventを利用して、矩形選択操作の開始点を記録する例です。これは、mouseMoveEventやmouseReleaseEventと組み合わせて、完全な矩形選択機能を実装する際の第一歩となります。

// myselectingscrollarea.h
#ifndef MYSELECTINGSCROLLAREA_H
#define MYSELECTINGSCROLLAREA_H

#include <QAbstractScrollArea>
#include <QMouseEvent>
#include <QPoint>
#include <QRect>
#include <QPainter> // 描画のために必要

class MySelectingScrollArea : public QAbstractScrollArea
{
    Q_OBJECT

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

protected:
    void mousePressEvent(QMouseEvent *event) override;
    void mouseMoveEvent(QMouseEvent *event) override; // ドラッグ中に必要
    void mouseReleaseEvent(QMouseEvent *event) override; // ドラッグ終了時に必要
    void paintEvent(QPaintEvent *event) override; // 選択範囲を描画するために必要

private:
    bool m_isSelecting; // ドラッグ中かどうかを示すフラグ
    QPoint m_selectionStartPos; // 選択開始時のマウス座標 (ビューポート内)
    QRect m_currentSelectionRect; // 現在の選択矩形 (ビューポート内)

    // デモ用のコンテンツ (実際は複雑な描画やアイテムなど)
    QVector<QRect> m_items;
    void generateDemoItems();
};

#endif // MYSELECTINGSCROLLAREA_H

// myselectingscrollarea.cpp
#include "myselectingscrollarea.h"
#include <QDebug>
#include <QApplication> // QRect::normalized()のため

MySelectingScrollArea::MySelectingScrollArea(QWidget *parent)
    : QAbstractScrollArea(parent),
      m_isSelecting(false)
{
    viewport()->setBackgroundRole(QPalette::Dark); // 背景を黒にする
    viewport()->setAutoFillBackground(true);
    setMouseTracking(true); // マウスボタンが押されていなくてもmouseMoveEventを発生させる

    // デモ用のアイテムを生成
    generateDemoItems();
}

void MySelectingScrollArea::generateDemoItems()
{
    // 適当な位置に四角いアイテムをいくつか作成
    qsrand(QDateTime::currentMSecsSinceEpoch() / 1000); // 乱数シード設定
    for (int i = 0; i < 20; ++i) {
        int x = qrand() % 800; // 仮想的なコンテンツサイズを考慮
        int y = qrand() % 800;
        int w = 50 + (qrand() % 50);
        int h = 50 + (qrand() % 50);
        m_items.append(QRect(x, y, w, h));
    }

    // スクロールエリアの仮想サイズを設定するために、コンテンツの最大範囲を計算
    // これは簡易的な例であり、本来はもっと堅牢な方法でコンテンツサイズを管理すべき
    int maxX = 0;
    int maxY = 0;
    for (const QRect& rect : qAsConst(m_items)) {
        maxX = qMax(maxX, rect.right());
        maxY = qMax(maxY, rect.bottom());
    }
    // ここで仮想的なコンテンツサイズに基づいてスクロールバーの範囲を調整する
    // これはQAbstractScrollAreaのsetViewportMargins()やscrollContentsBy()、
    // sizeHint()などをオーバーライドして行うのが適切だが、簡易的に。
    // 正確なスクロール範囲設定は、より複雑な実装が必要
}

void MySelectingScrollArea::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        m_isSelecting = true;
        // 選択開始点をビューポート内のローカル座標で記録
        m_selectionStartPos = event->pos();
        m_currentSelectionRect = QRect(m_selectionStartPos, m_selectionStartPos);
        qDebug() << "Selection started at: " << m_selectionStartPos;
    }
    // 基底クラスのイベントハンドラを呼び出す (通常はドラッグスクロールなどのデフォルト動作のため)
    QAbstractScrollArea::mousePressEvent(event);
}

void MySelectingScrollArea::mouseMoveEvent(QMouseEvent *event)
{
    if (m_isSelecting) {
        // 現在のマウス位置に基づいて選択矩形を更新
        m_currentSelectionRect = QRect(m_selectionStartPos, event->pos()).normalized();
        // normalized() は、矩形の幅や高さが負になる可能性を修正し、
        // 常に左上と幅/高さが正の形式に正規化します。
        
        // 再描画を要求
        viewport()->update();
    }
    // 基底クラスのイベントハンドラを呼び出す (マウスボタンが押されていない状態での移動イベントのため)
    QAbstractScrollArea::mouseMoveEvent(event);
}

void MySelectingScrollArea::mouseReleaseEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton && m_isSelecting) {
        m_isSelecting = false;
        // 選択終了点を取得し、最終的な選択矩形を確定
        m_currentSelectionRect = QRect(m_selectionStartPos, event->pos()).normalized();
        qDebug() << "Selection ended. Final Rect: " << m_currentSelectionRect;

        // ここで、m_currentSelectionRect を使用して、
        // 選択された領域内のアイテムを検出・処理するロジックを記述します。
        // 例: for (const QRect& itemRect : qAsConst(m_items)) { ... }

        // 選択矩形をリセット
        m_currentSelectionRect = QRect();
        // 再描画を要求 (選択矩形を消すため)
        viewport()->update();
    }
    // 基底クラスのイベントハンドラを呼び出す
    QAbstractScrollArea::mouseReleaseEvent(event);
}

void MySelectingScrollArea::paintEvent(QPaintEvent *event)
{
    QPainter painter(viewport());
    painter.setRenderHint(QPainter::Antialiasing);

    // スクロールオフセットを考慮
    // QAbstractScrollAreaのpaintEventは、ビューポートのローカル座標で動作するため、
    // ここでスクロールバーの値を考慮する必要があります。
    // このオフセットを、描画する全ての要素に適用します。
    QPointF offset(-horizontalScrollBar()->value(), -verticalScrollBar()->value());
    painter.translate(offset);

    // デモ用のアイテムを描画
    for (const QRect& rect : qAsConst(m_items)) {
        painter.setPen(Qt::NoPen);
        painter.setBrush(Qt::blue);
        painter.drawRect(rect);
    }

    // 選択中の矩形を描画 (ドラッグ中のみ)
    if (m_isSelecting) {
        painter.setPen(QPen(Qt::green, 2, Qt::DashLine)); // 緑の点線
        painter.setBrush(QColor(0, 255, 0, 50)); // 半透明の緑
        painter.drawRect(m_currentSelectionRect);
    }
    
    // QAbstractScrollAreaのpaintEventは、基底クラスの呼び出しは不要
    // QWidget::paintEvent()はデフォルトで何もしない
    // QAbstractScrollAreaのpaintEventは、ビューポートの描画を管理するため、
    // 必要に応じて自身のコンテンツを描画する
}

使用例 (main.cpp)

// main.cpp (上記と同じようにQApplication, QMainWindow, QVBoxLayoutなどを設定)
#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include "myselectingscrollarea.h" // MySelectingScrollArea をインクルード

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

    QMainWindow window;
    window.setWindowTitle("Selecting Scroll Area Example");
    window.resize(800, 600); // ウィンドウサイズを調整

    MySelectingScrollArea *scrollArea = new MySelectingScrollArea(&window);
    
    // スクロール可能な領域のサイズを大きく設定 (これによりスクロールバーが表示される)
    // ここでは、paintEvent で描画されるコンテンツの最大サイズを考慮して設定
    // 適切なスクロールバーの表示のためには、QAbstractScrollArea::scrollContentsBy()や
    // sizeHint()などをオーバーライドして、内部コンテンツの論理的なサイズをQtに伝える必要がある
    // ここでは単純化のため、ウィジェットのサイズを設定して仮のスクロールエリアとする
    scrollArea->setMinimumSize(700, 500); // 自身のウィジェットとしての最小サイズ
    
    // スクロールバーのポリシーを設定
    scrollArea->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
    scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
    
    // 重要なポイント: QAbstractScrollArea::setViewport() を使ってカスタムビューポートをセットするか、
    // または QAbstractScrollArea::viewport() の paintEvent を直接オーバーライドする。
    // 上の例では、MySelectingScrollArea::paintEvent が呼ばれると自動的に viewport() の paintEvent が呼ばれる。

    QVBoxLayout *layout = new QVBoxLayout();
    layout->addWidget(scrollArea);

    QWidget *centralWidget = new QWidget();
    centralWidget->setLayout(layout);
    window.setCentralWidget(centralWidget);

    window.show();

    return a.exec();
}

コードの説明と重要なポイント:

#include <QMouseEvent>: マウスイベントの情報を取得するために必要です。
override キーワード: C++11以降で導入されたキーワードで、基底クラスの仮想関数をオーバーライドしていることを明示します。これにより、誤った関数シグネチャによるエラーを防ぎます。
QMouseEvent *event: このポインタを通じて、イベントの種類、マウスの位置（ローカル座標とグローバル座標）、押されたボタン、修飾キーの状態などの情報にアクセスできます。
- event->button(): 現在押された（または離された）ボタンを返します（例: Qt::LeftButton, Qt::RightButton）。
- event->pos(): イベントが発生したウィジェットのローカル座標（左上が(0,0)）を返します。QAbstractScrollAreaの場合、これはビューポート内の座標になります。
- event->globalPos(): スクリーン全体のグローバル座標を返します。
QAbstractScrollArea::mousePressEvent(event); の呼び出し:
- 重要です！ オーバーライドした関数内で、この基底クラスのイベントハンドラを呼び出すことを強く推奨します。これにより、QAbstractScrollAreaが提供するデフォルトのスクロール動作（例: マウスドラッグによるスクロール）が機能し続けます。
- もし、イベントを完全に処理し、それ以上親ウィジェットや基底クラスに伝播させたくない場合は、この呼び出しを省略するか、event->accept();を呼び出した後にreturn;することができます。しかし、通常はデフォルトの動作を維持しつつ、カスタム処理を追加することが多いです。
座標変換 (スクロールオフセット):
- QAbstractScrollAreaのviewport()で描画されるコンテンツは、スクロールによって表示位置が変わります。event->pos()はビューポート内の座標ですが、もしコンテンツ全体（仮想的な大きなキャンバス）内の座標が必要な場合、スクロールバーの値（horizontalScrollBar()->value(), verticalScrollBar()->value()）をevent->pos()に加算して変換する必要があります。
- 例2のpaintEventでは、painter.translate(offset);によって描画システム自体にスクロールオフセットを適用しています。これにより、m_itemsやm_currentSelectionRectを定義したそのままの座標で描画できます。
setMouseTracking(true):
- 例2ではmouseMoveEventも使用しています。通常、mouseMoveEventはマウスボタンが押されている間のみ発生します。しかし、マウスボタンが押されていない状態でもマウスの動きを追跡したい場合は、setMouseTracking(true)をウィジェットに設定する必要があります。今回のドラッグ選択の例では、mousePressEventでドラッグが開始されるため、厳密にはmouseMoveEventでsetMouseTracking(true)は必須ではありませんが、より汎用的なマウス追跡のために設定しておくと良いでしょう。

これらの例は、QAbstractScrollArea::mousePressEventの基本的な使い方と、他のイベントハンドラや描画処理との連携方法を示しています。実際のアプリケーションでは、さらに複雑なインタラクションやロジックが追加されることになります。 Qtプログラミングにおけるvoid QAbstractScrollArea::mousePressEvent(QMouseEvent *event)に関連する具体的なプログラミング例をいくつかご紹介します。

例1: 基本的なマウスプレスイベントの検出

最も基本的な例として、QAbstractScrollAreaを継承したカスタムウィジェット内でマウスの左ボタンが押されたことを検出するコードです。

MyScrollArea.h

#ifndef MYSCROLLAREA_H
#define MYSCROLLAREA_H

#include <QAbstractScrollArea>
#include <QMouseEvent>
#include <QDebug> // デバッグ出力用

class MyScrollArea : public QAbstractScrollArea
{
    Q_OBJECT // Qtのメタオブジェクトシステムを使用するために必要

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

protected:
    // mousePressEventをオーバーライド
    void mousePressEvent(QMouseEvent *event) override;
};

#endif // MYSCROLLAREA_H

MyScrollArea.cpp

#include "MyScrollArea.h"

MyScrollArea::MyScrollArea(QWidget *parent)
    : QAbstractScrollArea(parent)
{
    // ビューポートを作成（QAbstractScrollAreaは直接描画せず、viewportに描画する）
    // 通常、QAbstractScrollAreaのサブクラスでは、
    // setViewport(new MyCustomViewportWidget(this)) のようにカスタムのビューポートを
    // 設定することが多いですが、ここでは単純化のためにデフォルトのQAbstractScrollArea::viewport()を使用します。
    // setViewport(new QWidget()); // もしカスタムのビューポートが必要なら
}

void MyScrollArea::mousePressEvent(QMouseEvent *event)
{
    // マウスの左ボタンが押されたかチェック
    if (event->button() == Qt::LeftButton) {
        // イベント発生時のローカル座標（ウィジェット内の座標）
        QPoint pos = event->pos();
        qDebug() << "MyScrollAreaで左ボタンが押されました。座標: " << pos;

        // ここに左クリック時のカスタム処理を記述します
        // 例: 特定の要素の選択、ドラッグ開始位置の記憶など
    }
    // マウスの右ボタンが押されたかチェック
    else if (event->button() == Qt::RightButton) {
        QPoint pos = event->pos();
        qDebug() << "MyScrollAreaで右ボタンが押されました。座標: " << pos;
        // ここに右クリック時のカスタム処理を記述します
    }

    // 重要: 基底クラスのmousePressEventを呼び出す
    // これにより、QAbstractScrollAreaが提供するデフォルトの動作（例: スクロールバーの動作）が
    // 引き続き機能します。イベントを完全に「消費」して親に伝播させたくない場合は
    // event->accept()を呼び出し、この行をコメントアウトするか、returnします。
    QAbstractScrollArea::mousePressEvent(event);
}

main.cpp (アプリケーションの起動コード)

#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include <QLabel> // スクロールエリア内に表示するコンテンツの例
#include "MyScrollArea.h"

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

    QMainWindow window;
    window.setWindowTitle("QAbstractScrollArea Mouse Press Event Example");
    window.resize(600, 400);

    MyScrollArea *scrollArea = new MyScrollArea(&window);
    // スクロールエリアに表示するコンテンツを作成
    QLabel *contentLabel = new QLabel("<h1>非常に長いコンテンツ</h1>"
                                     "<p>これはスクロールエリア内に表示されるサンプルテキストです。</p>"
                                     "<p>テキストをたくさん追加して、スクロールバーが表示されるようにします。</p>"
                                     "<p>...</p>" // 長いテキストをシミュレート
                                     "<p>...</p>"
                                     "<p>...</p>"
                                     "<p>スクロールして、どこでもクリックしてみてください。</p>", scrollArea);
    contentLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft);
    contentLabel->setWordWrap(true); // 折り返し設定

    // QScrollArea::setWidget() のように、QAbstractScrollAreaは直接ウィジェットを設定しません。
    // 代わりに、QAbstractScrollAreaのビューポートにウィジェットを配置します。
    // しかし、ここでは MyScrollArea が QAbstractScrollArea を継承しているため、
    // ビューポートに直接コンテンツを設定する必要があります。
    // 簡単な方法として、コンテンツをスクロールエリアのビューポートの親として設定します。
    // ただし、より堅牢なアプローチとしては、QScrollAreaを使用するか、
    // カスタムビューポートウィジェットを作成し、その中にコンテンツを配置します。
    
    // QScrollArea のようにコンテンツをセットする場合
    // QScrollArea *qScrollArea = new QScrollArea(&window);
    // qScrollArea->setWidget(contentLabel);
    // qScrollArea->setWidgetResizable(true); // ウィジェットのサイズ変更に合わせてリサイズ

    // MyScrollArea (QAbstractScrollArea の直接継承) の場合、viewport() にコンテンツを配置します。
    // 通常は、QAbstractScrollArea::setViewport() でカスタムウィジェットを設定し、
    // そのカスタムウィジェットがコンテンツを描画するか、子ウィジェットを配置します。
    // ここでは単純化のため、viewportを直接取得して、その中にcontentLabelを入れます。
    // ただし、これにより contentLabel がスクロールエリアのサイズを超える場合でも
    // スクロールバーが自動的に表示されるわけではありません。
    // QAbstractScrollArea が提供するスクロール機構を完全に利用するには、
    // scrollContentsBy() を適切に実装するか、QScrollArea を使う方が簡単です。
    
    // 例を単純化し、MyScrollArea のビューポート内に QLabel を直接配置してみます。
    // この場合、QLabel が MyScrollArea のビューポートの子になります。
    // QLabel のサイズがビューポートを超えると、スクロールバーが必要になりますが、
    // その制御は QAbstractScrollArea のサブクラスが担当します。
    // QAbstractScrollArea は抽象クラスであるため、そのままではスクロールバーは自動で出ません。
    // QScrollArea を使う方が遥かに簡単です。
    // 以下は、QAbstractScrollArea を直接使った場合の、手動でのコンテンツ設定とサイズ調整の基本的な考え方です。
    
    // 実際には、QAbstractScrollArea::setViewport(new CustomViewportWidget(this))
    // とし、CustomViewportWidget 内でコンテンツを管理・描画し、
    // MyScrollArea::scrollContentsBy() をオーバーライドしてスクロールを実装します。
    // ここでは、QScrollArea を使うより複雑な QAbstractScrollArea のイベント処理を示すため、
    // 簡略化して MyScrollArea の viewport() に直接QLabelを子として設定します。
    // この方法では、QLabelがスクロールエリアのサイズを超えてもスクロールバーは機能しません。
    // mousePressEventの検出に焦点を当てています。
    
    scrollArea->setWidgetResizable(true); // QAbstractScrollArea::setWidgetResizable は QScrollArea のメンバーです
                                         // MyScrollArea は QAbstractScrollArea を直接継承しているので使えません
                                         // ここでは QAbstractScrollArea の基本的なイベントハンドリングのみを示します
    
    // QScrollArea の代替として QAbstractScrollArea を使う場合、
    // 通常はカスタムの QWidget を setViewport() に渡し、そのカスタムウィジェットが
    // コンテンツを描画したり、子ウィジェットを配置したりします。
    // そして、QAbstractScrollArea の scrollContentsBy() をオーバーライドして、
    // そのカスタムウィジェットの描画オフセットを調整することでスクロールを実装します。
    
    // 簡易的な方法として、QScrollArea を使った場合の例に切り替えます
    // MyScrollArea が QScrollArea を継承していれば、setWidget() が使えます。
    // 例示のために、MyScrollAreaをQScrollAreaから継承するように変更し、setWidget()を使用します。
    // (上記の MyScrollArea.h/.cpp も QScrollArea を継承するように変更してください)
    
    // もし本当にQAbstractScrollAreaを直接使って手動で描画とスクロールを制御するなら、
    // より複雑な`paintEvent`と`scrollContentsBy`の実装が必要です。
    // ここでは`mousePressEvent`の例なので、`QScrollArea`を継承したシンプルな例に切り替えます。
    
    // MyScrollArea を QScrollArea から継承するように変更した場合:
    // (MyScrollArea.h: class MyScrollArea : public QScrollArea; MyScrollArea.cpp: MyScrollArea::MyScrollArea(...) : QScrollArea(parent))
    // その上で以下を実行。
    scrollArea->setWidget(contentLabel); // QScrollArea の機能でコンテンツを設定
    scrollArea->setWidgetResizable(true); // コンテンツに合わせてスクロールエリアがリサイズされるようにする

    QWidget *centralWidget = new QWidget(&window);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);
    layout->addWidget(scrollArea);
    window.setCentralWidget(centralWidget);

    window.show();

    return a.exec();
}

変更点: MyScrollArea を QScrollArea から継承するようにします。 （QAbstractScrollAreaを直接使うと、スクロールバーの制御やコンテンツの配置がより複雑になります。mousePressEventのオーバーライド自体は同じですが、例として分かりやすくするためです。）

MyScrollArea.h (更新)

#ifndef MYSCROLLAREA_H
#define MYSCROLLAREA_H

#include <QScrollArea> // QAbstractScrollArea の代わりに QScrollArea を継承
#include <QMouseEvent>
#include <QDebug>

class MyScrollArea : public QScrollArea // QScrollArea を継承
{
    Q_OBJECT

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

protected:
    void mousePressEvent(QMouseEvent *event) override;
};

#endif // MYSCROLLAREA_H

MyScrollArea.cpp (更新)

#include "MyScrollArea.h"

MyScrollArea::MyScrollArea(QWidget *parent)
    : QScrollArea(parent) // QScrollArea のコンストラクタを呼び出す
{
    // QScrollArea はデフォルトでビューポートとスクロールバーを管理します
    // 必要に応じてここで追加の設定ができます
    // 例: setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
}

void MyScrollArea::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        QPoint pos = event->pos();
        qDebug() << "MyScrollAreaで左ボタンが押されました。ビューポート内座標: " << pos;

        // ビューポートの座標をスクロールされているコンテンツの座標に変換する
        // スクロールオフセットを考慮する
        QPoint contentPos = pos + QPoint(horizontalScrollBar()->value(), verticalScrollBar()->value());
        qDebug() << "コンテンツ内座標: " << contentPos;
        
        // ここにカスタム処理を記述
    }
    else if (event->button() == Qt::RightButton) {
        QPoint pos = event->pos();
        qDebug() << "MyScrollAreaで右ボタンが押されました。座標: " << pos;
    }

    // 基底クラスのmousePressEventを呼び出すことで、QScrollAreaのデフォルトのスクロール動作などを維持
    QScrollArea::mousePressEvent(event);
}

例2: ドラッグ操作の開始を検出する

mousePressEventを使ってドラッグ操作の開始を検出し、その後のmouseMoveEventでドラッグを処理し、mouseReleaseEventで終了する典型的なパターンです。

MyDraggableScrollArea.h

#ifndef MYDRAGGABLESCROLLAREA_H
#define MYDRAGGABLESCROLLAREA_H

#include <QScrollArea>
#include <QMouseEvent>
#include <QDebug>
#include <QPoint>

class MyDraggableScrollArea : public QScrollArea
{
    Q_OBJECT

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

protected:
    void mousePressEvent(QMouseEvent *event) override;
    void mouseMoveEvent(QMouseEvent *event) override;
    void mouseReleaseEvent(QMouseEvent *event) override;

private:
    bool m_isDragging;      // ドラッグ中かどうかのフラグ
    QPoint m_lastMousePos;  // ドラッグ開始時のマウス位置または前回のマウス位置
};

#endif // MYDRAGGABLESCROLLAREA_H

MyDraggableScrollArea.cpp

#include "MyDraggableScrollArea.h"

MyDraggableScrollArea::MyDraggableScrollArea(QWidget *parent)
    : QScrollArea(parent),
      m_isDragging(false) // 初期化
{
    // マウスボタンが押されていない状態でもmouseMoveEventを発生させる
    // ドラッグ中にカーソルがウィジェット外に出てもイベントを受け取るために重要
    // ただし、この例ではマウスプレスからのドラッグなので、通常は不要です。
    // setMouseTracking(true); 
    // QScrollAreaは通常、内部のウィジェットをセットするため、
    // QScrollArea::viewport()にsetMouseTracking(true)を設定する必要があるかもしれません。
    // setMouseTracking(true)はQScrollAreaではなくviewportに設定することが多いです。
    // viewport()->setMouseTracking(true);
}

void MyDraggableScrollArea::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        m_isDragging = true;
        m_lastMousePos = event->pos(); // ビューポート内の座標を記憶
        qDebug() << "ドラッグ開始。初期座標: " << m_lastMousePos;

        // イベントを処理したことを示す
        event->accept(); 
        // このイベントはQScrollAreaのデフォルトのスクロール動作（ハンドスクロールなど）を
        // 妨げる可能性があります。もしデフォルトの動作も必要なら
        // QScrollArea::mousePressEvent(event); を呼び出すか、
        // event->ignore() を使って親にイベントを伝播させます。
        // ここではカスタムドラッグに焦点を当てているので、accept()します。
    } else {
        // それ以外のボタンのイベントは基底クラスに任せる
        QScrollArea::mousePressEvent(event);
    }
}

void MyDraggableScrollArea::mouseMoveEvent(QMouseEvent *event)
{
    if (m_isDragging && event->buttons() & Qt::LeftButton) { // 左ボタンが押されながら移動中
        QPoint delta = event->pos() - m_lastMousePos; // 移動量

        // ここにドラッグ中のカスタム処理を記述します
        // 例: コンテンツの表示オフセットを変更してスクロールさせる
        // QScrollArea::horizontalScrollBar()->setValue(QScrollArea::horizontalScrollBar()->value() - delta.x());
        // QScrollArea::verticalScrollBar()->setValue(QScrollArea::verticalScrollBar()->value() - delta.y());
        
        qDebug() << "ドラッグ中。移動量: " << delta;
        
        // 例: ビューポート内の要素の位置を移動
        // ただし、QScrollArea::setWidget() で設定したウィジェットを動かすのは推奨されません。
        // 代わりに、ビューポート内に直接描画している要素のオフセットを調整するべきです。
        
        // 別の方法として、QScrollArea::scrollContentsBy() を呼び出してスクロールすることもできますが、
        // QScrollArea がデフォルトで提供するドラッグスクロールと競合する可能性があります。
        
        // この例では、単純にドラッグ量をデバッグ出力するだけにとどめます。
        // 実際のアプリケーションでは、ビューポート内の描画要素や、
        // setWidget()で設定されたウィジェット（もしカスタム描画しているなら）の
        // `QPainter`の変換行列などを調整してスクロールを実装します。

        // ドラッグ移動量がコンテンツに影響する場合、ビューポートを更新
        viewport()->update(); // または repaint();
        
        m_lastMousePos = event->pos(); // 次のフレームのために現在の位置を記憶

        event->accept(); // イベントを処理したことを示す
    } else {
        QScrollArea::mouseMoveEvent(event); // 基底クラスのイベントも処理
    }
}

void MyDraggableScrollArea::mouseReleaseEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton && m_isDragging) {
        m_isDragging = false;
        qDebug() << "ドラッグ終了。最終座標: " << event->pos();

        // ここにドラッグ終了時のカスタム処理を記述
        event->accept(); // イベントを処理したことを示す
    } else {
        QScrollArea::mouseReleaseEvent(event); // 基底クラスのイベントも処理
    }
}

main.cpp (MyDraggableScrollArea を使用) （例1のmain.cppでMyScrollAreaをMyDraggableScrollAreaに置き換えるだけです。）

#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include <QLabel> // スクロールエリア内に表示するコンテンツの例
#include "MyDraggableScrollArea.h" // 新しいヘッダをインクルード

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

    QMainWindow window;
    window.setWindowTitle("Draggable Scroll Area Example");
    window.resize(600, 400);

    MyDraggableScrollArea *scrollArea = new MyDraggableScrollArea(&window);
    QLabel *contentLabel = new QLabel("<h1>ドラッグ可能なコンテンツ</h1>"
                                     "<p>このエリア内で左クリックしてドラッグしてみてください。</p>"
                                     "<p>...</p><p>...</p><p>...</p><p>...</p>" // 長いコンテンツ
                                     "<p>コンテンツが非常に長いため、スクロールバーが表示されるはずです。</p>"
                                     "<p>ここにはさらに多くのテキストがあります。</p>"
                                     "<p>...</p><p>...</p><p>...</p><p>...</p>"
                                     "<p>スクロールして、どこでもクリックしてみてください。</p>", scrollArea);
    contentLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft);
    contentLabel->setWordWrap(true);
    
    // QLabelが大きすぎると、QLabelが自動的にスクロールエリアのサイズを決定するため、
    // mousePressEventをオーバーライドしても、QScrollAreaが提供するハンドドラッグと競合します。
    // 代わりに、QLabelのサイズを大きく設定し、スクロールバーが表示されるようにします。
    contentLabel->setMinimumSize(800, 1200); // 意図的に大きなサイズを設定してスクロールバーを表示

    scrollArea->setWidget(contentLabel);
    scrollArea->setWidgetResizable(true); // ウィジェットのサイズに合わせてリサイズする（ただし、コンテンツのmin/maxサイズも考慮）

    QWidget *centralWidget = new QWidget(&window);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);
    layout->addWidget(scrollArea);
    window.setCentralWidget(centralWidget);

    window.show();

    return a.exec();
}

基底クラスの呼び出し: QAbstractScrollArea::mousePressEvent(event); を呼び出すことは非常に重要です。これを怠ると、Qtが提供するデフォルトのスクロール動作などが失われる可能性があります。通常は、カスタム処理を行った後、またはカスタム処理でイベントを完全に処理しない場合に呼び出します。
event->accept() / event->ignore(): イベントの伝播を制御します。
- event->accept(): イベントはこのウィジェットで処理され、それ以上親ウィジェットには伝播しません。これがデフォルトの動作です。
- event->ignore(): イベントはこのウィジェットでは処理されず、親ウィジェットに伝播します。
event->buttons(): mouseMoveEventなどで、現在どのボタンが押されているか（複数のボタンが同時に押されている場合も）をビットマスクで取得します。
event->globalPos(): イベントが発生したスクリーン上のグローバル座標を取得します。
event->pos(): イベントが発生したウィジェット内のローカル座標（ウィジェットの左上が(0,0)）を取得します。
event->button(): どのマウスボタンが押されたかを判定します（Qt::LeftButton, Qt::RightButton, Qt::MidButtonなど）。
override: 仮想関数をオーバーライドしていることを明示します。これはコンパイラによるチェックを可能にし、タイプミスなどによる問題を早期に発見するのに役立ちます。
#include <QMouseEvent>: マウスイベントの情報を取得するために必要です。

イベントフィルター (Event Filter)

イベントフィルターは、特定のオブジェクト（ウィジェットなど）が受け取るイベントを、そのオブジェクト自身が処理する前に横取りして処理するための強力なメカニズムです。これにより、ウィジェットをサブクラス化せずにイベントを監視・処理することができます。

特徴

グローバルフィルター
QApplicationまたはQCoreApplicationにイベントフィルターをインストールすると、アプリケーション内のすべてのオブジェクトのイベントを監視できます（ただし、パフォーマンスへの影響に注意が必要です）。
イベントの伝播制御
eventFilter()関数内でtrueを返せばイベントを消費（停止）し、falseを返せばイベントをターゲットオブジェクトに伝播させることができます。
柔軟性
複数のウィジェットのイベントを一つのフィルターオブジェクトで処理できます。
非侵襲的
既存のウィジェットの動作を変更することなく、イベントを監視できます。

使用例
あるQAbstractScrollArea（またはそれを継承したQScrollArea）の子ウィジェットのクリックイベントを、親のQAbstractScrollArea側で処理したい場合などに便利です。

実装ステップ

イベントを監視したいオブジェクト（フィルターオブジェクト）にeventFilter(QObject *watched, QEvent *event)仮想関数を実装します。この関数はQObjectクラスのメンバーです。
イベントを監視されたいオブジェクト（ターゲットオブジェクト）に対して、フィルターオブジェクトのインスタンスをinstallEventFilter()で登録します。

コード例

// MyEventFilter.h
#ifndef MYEVENTFILTER_H
#define MYEVENTFILTER_H

#include <QObject>
#include <QEvent>
#include <QMouseEvent>
#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::MouseButtonPress) {
            QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);

            // どのオブジェクトでイベントが発生したか
            qDebug() << "イベントフィルター: " << watched->objectName() << " でマウスが押されました。";
            qDebug() << "座標: " << mouseEvent->pos();
            qDebug() << "ボタン: " << mouseEvent->button();

            // 例: 特定のボタンが押されたらイベントを消費する
            if (mouseEvent->button() == Qt::RightButton) {
                qDebug() << "右クリックはイベントフィルターで処理され、伝播を停止しました。";
                return true; // イベントを消費し、ターゲットオブジェクトには伝播させない
            }
        }
        // それ以外のイベント、または右クリック以外のマウスプレスイベントはターゲットオブジェクトに伝播させる
        return QObject::eventFilter(watched, event); // 基底クラスのイベントフィルターを呼び出す
    }
};

#endif // MYEVENTFILTER_H

// main.cpp (MyScrollArea を使用する場合)
#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include <QLabel>
#include <QPushButton> // 例として子ウィジェットを追加
#include "MyScrollArea.h" // 例1で作成した MyScrollArea (QScrollArea継承)
#include "MyEventFilter.h" // 新しく作成したイベントフィルター

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

    QMainWindow window;
    window.setWindowTitle("Event Filter Example");
    window.resize(600, 400);

    MyScrollArea *scrollArea = new MyScrollArea(&window);
    QLabel *contentLabel = new QLabel("<h1>イベントフィルターテスト</h1>"
                                     "<p>このエリア内でどこでもクリックしてみてください。</p>"
                                     "<p>特に、以下のボタンをクリックしてみてください。</p>", scrollArea);
    contentLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft);
    contentLabel->setWordWrap(true);
    contentLabel->setMinimumSize(800, 1200);

    QPushButton *button = new QPushButton("テストボタン", contentLabel); // QLabelの子としてボタンを配置
    button->setGeometry(50, 200, 150, 40); // 位置とサイズを設定
    button->setObjectName("TestButton"); // オブジェクト名を付けて識別しやすくする

    scrollArea->setWidget(contentLabel);
    scrollArea->setWidgetResizable(true);

    // イベントフィルターのインスタンスを作成
    MyEventFilter *filter = new MyEventFilter(&window); // 親をwindowにして、ライフサイクルを管理

    // スクロールエリア（ターゲットオブジェクト）にイベントフィルターをインストール
    // これにより、MyScrollAreaが受け取るすべてのイベントをMyEventFilterが先に処理する
    scrollArea->installEventFilter(filter);
    
    // 子ウィジェットのイベントも監視したい場合
    // この場合、buttonがイベントをaccept()するため、親のscrollAreaには伝播しないことが多い
    // button->installEventFilter(filter); // ボタンのイベントもフィルターで捕捉したい場合

    QWidget *centralWidget = new QWidget(&window);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);
    layout->addWidget(scrollArea);
    window.setCentralWidget(centralWidget);

    window.show();

    return a.exec();
}

考察
イベントフィルターは、特に既存のクラスのイベント挙動を、そのクラス自体を変更することなく（サブクラス化せずに）変更したい場合に有効です。また、複数のオブジェクトのイベントを一箇所で処理したい場合にも適しています。

QObject::event() の再実装

すべてのQObject（そしてQWidgetもQObjectを継承しています）は、すべてのイベントが最終的に通過する仮想関数event(QEvent *event)を持っています。mousePressEvent()のような特定のイベントハンドラは、実際にはevent()関数がイベントの種類を調べて適切なハンドラ（例: mousePressEvent）を呼び出すことで機能しています。

特徴

注意が必要
イベントのタイプを自分でチェックし、適切な型にキャストして処理する必要があります。また、デフォルトの処理を維持するために基底クラスのevent()を呼び出す必要があります。
強力
ほとんどすべてのイベントをここで処理できます。
最も低レベル
特定のイベントハンドラが呼び出されるよりも前に、すべてのイベントを捕捉できます。

使用例
非常に特殊なイベント処理ロジックが必要な場合や、複数の異なる種類のイベントを単一の関数で一元的に処理したい場合に検討できます。ただし、一般的なマウスイベント処理にはmousePressEventなどの専用ハンドラを使用する方が、コードの可読性と保守性が高いため、あまり推奨されません。

コード例

// MyCustomWidget.h
#ifndef MYCUSTOMWIDGET_H
#define MYCUSTOMWIDGET_H

#include <QWidget>
#include <QEvent>
#include <QMouseEvent>
#include <QDebug>

class MyCustomWidget : public QWidget
{
    Q_OBJECT
public:
    explicit MyCustomWidget(QWidget *parent = nullptr) : QWidget(parent) {}

protected:
    // event()関数をオーバーライド
    bool event(QEvent *event) override
    {
        if (event->type() == QEvent::MouseButtonPress) {
            QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);
            qDebug() << "QObject::event() でマウスプレスイベントを検出しました。";
            qDebug() << "座標: " << mouseEvent->pos();
            qDebug() << "ボタン: " << mouseEvent->button();

            // このイベントをここで完全に処理し、これ以上伝播させたくない場合
            // return true;

            // 通常は、ここで特定のイベントハンドラにディスパッチされるのを許可するため、
            // 基底クラスのevent()を呼び出すか、falseを返して伝播を継続させる
        }
        
        // 基底クラスのevent()を呼び出すことで、デフォルトのイベントディスパッチを維持する
        return QWidget::event(event);
    }
};

#endif // MYCUSTOMWIDGET_H

考察
この方法は非常に強力ですが、通常はmousePressEventのような特定のイベントハンドラやイベントフィルターを使う方が、より安全でQtの設計思想に沿っています。event()を直接オーバーライドするのは、他の方法では実現できない、より複雑なイベント処理ロジックが必要な場合に限定すべきです。

これはマウスプレスイベントを直接処理する代替方法というよりは、イベントハンドラ内で検出したマウスイベントに基づいて、他のオブジェクトに通知・連携するためのQtの主要なメカニズムです。

QAbstractScrollArea::mousePressEvent()をオーバーライドし、その中でカスタムシグナルを発行（emit）し、そのシグナルを別のオブジェクトの任意のスロットに接続することで、イベントを処理するウィジェットと、そのイベントに応答するロジックを分離できます。

特徴

強力な連携
多くのオブジェクトがシグナルに接続したり、一つのシグナルが複数のスロットに接続されたりできます。
タイプセーフ
シグナルとスロットの引数の型が一致しているかをコンパイル時にチェックできます（新しい接続構文を使用する場合）。
疎結合
イベントの発行元と受信側が直接依存しないため、コードの柔軟性と再利用性が向上します。

使用例
カスタムのスクロールエリア上でユーザーが特定の部分をクリックしたときに、アプリケーションのメインウィンドウやデータモデルなど、他の部分がそのクリックに応答する必要がある場合。

コード例

MyClickableScrollArea.h

#ifndef MYCLICKABLESCROLLAREA_H
#define MYCLICKABLESCROLLAREA_H

#include <QScrollArea>
#include <QMouseEvent>
#include <QPoint>
#include <QDebug>

class MyClickableScrollArea : public QScrollArea
{
    Q_OBJECT

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

signals:
    // カスタムのシグナルを定義。クリックされた座標を渡す
    void areaClicked(const QPoint &posInContent);

protected:
    void mousePressEvent(QMouseEvent *event) override;
};

#endif // MYCLICKABLESCROLLAREA_H

MyClickableScrollArea.cpp

#include "MyClickableScrollArea.h"

MyClickableScrollArea::MyClickableScrollArea(QWidget *parent)
    : QScrollArea(parent)
{
}

void MyClickableScrollArea::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        QPoint viewportPos = event->pos(); // ビューポート内の座標

        // コンテンツ内の座標に変換
        QPoint contentPos = viewportPos + QPoint(horizontalScrollBar()->value(), verticalScrollBar()->value());

        qDebug() << "MyClickableScrollAreaでクリックされました。ビューポート座標: " << viewportPos;
        qDebug() << "MyClickableScrollAreaでクリックされました。コンテンツ座標: " << contentPos;

        // カスタムシグナルを発行
        emit areaClicked(contentPos);

        event->accept(); // このイベントはここで処理済み
    } else {
        QScrollArea::mousePressEvent(event); // それ以外のイベントは基底クラスに任せる
    }
}

main.cpp (MyClickableScrollArea とシグナル・スロットを使用)

#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include <QLabel>
#include "MyClickableScrollArea.h" // 新しいヘッダをインクルード

class MainWindow : public QMainWindow
{
    Q_OBJECT // シグナル・スロットを使用するために必要

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

private slots:
    void handleAreaClick(const QPoint &pos); // クリックイベントを受け取るスロット

private:
    QLabel *statusLabel;
};

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent)
{
    setWindowTitle("Signals & Slots for Mouse Press Example");
    resize(600, 400);

    MyClickableScrollArea *scrollArea = new MyClickableScrollArea(this);
    QLabel *contentLabel = new QLabel("<h1>クリック可能なスクロールエリア</h1>"
                                     "<p>このエリア内で左クリックしてください。クリックした座標がステータスバーに表示されます。</p>"
                                     "<p>...</p><p>...</p><p>...</p><p>...</p>" // 長いコンテンツ
                                     "<p>さらに多くのテキストがあります。</p>"
                                     "<p>...</p><p>...</p><p>...</p><p>...</p>"
                                     "<p>ここをクリック！</p>", scrollArea);
    contentLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft);
    contentLabel->setWordWrap(true);
    contentLabel->setMinimumSize(800, 1200); // スクロールバーを表示させるため

    scrollArea->setWidget(contentLabel);
    scrollArea->setWidgetResizable(true);

    // カスタムシグナルとスロットを接続
    connect(scrollArea, &MyClickableScrollArea::areaClicked,
            this, &MainWindow::handleAreaClick);

    statusLabel = new QLabel("クリック待機中...", this);
    statusBar()->addWidget(statusLabel); // ステータスバーに表示

    QWidget *centralWidget = new QWidget(this);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);
    layout->addWidget(scrollArea);
    setCentralWidget(centralWidget);
}

void MainWindow::handleAreaClick(const QPoint &pos)
{
    statusLabel->setText(QString("エリアがクリックされました。コンテンツ座標: (%1, %2)").arg(pos.x()).arg(pos.y()));
    qDebug() << "MainWindowのスロットでイベントを受け取りました。座標: " << pos;
}

#include "main.moc" // mocファイルを含める（QtCreatorでビルドする場合自動生成される）

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}

考察
シグナルとスロットは、Qtで推奨されるオブジェクト間通信のパターンです。イベント処理をウィジェット自体から分離し、他のコンポーネントにその情報を提供する際に非常に有効です。複雑なアプリケーションでは、この方法でマウスイベント情報を伝達することが一般的です。

シグナルとスロット
mousePressEvent()内でカスタムシグナルを発行し、そのシグナルを他のオブジェクトのスロットに接続することで、イベント処理ロジックを分離し、コンポーネント間の疎結合を促進します。
QObject::event()の再実装
全てのイベントを低レベルで捕捉したい場合に限って使用します。通常は、より高レベルなイベントハンドラやイベントフィルターが推奨されます。
イベントフィルター
既存のウィジェットのイベントを、そのウィジェットを変更せずに監視・処理したい場合に有効です。親ウィジェットから子ウィジェットのイベントを監視したり、アプリケーション全体のイベントを監視したりするのに使われます。
mousePressEvent()のオーバーライド
最も直接的で一般的な方法。ウィジェット自身の挙動をカスタマイズするのに適しています。

Qtマウスイベント処理の選択肢：mousePressEvent以外の代替手法を徹底解説

void QAbstractScrollArea::mousePressEvent(QMouseEvent *event) とは

どのような時に呼び出されるか

引数 QMouseEvent *event について

イベントがまったく発生しない/検出されない

座標が期待通りでない

イベントが複数回発生する、または意図せず連鎖する

mouseMoveEventと連携したドラッグ操作がうまくいかない

子ウィジェット上でのクリックが親のQAbstractScrollAreaに伝わらない

例1: 単純なクリックイベントの検出と座標表示

例2: ドラッグによる矩形選択の開始

コードの説明と重要なポイント:

例1: 基本的なマウスプレスイベントの検出

例2: ドラッグ操作の開始を検出する

イベントフィルター (Event Filter)

QObject::event() の再実装

`void QAbstractScrollArea::mousePressEvent(QMouseEvent *event)` とは

引数 `QMouseEvent *event` について