【初心者向け】Qt GUIプログラミング：マウスカーソルでウィジェットを操るQHoverEventクラスの使い方

QHoverEvent クラスは、マウスカーソルがウィジェットの上を移動すると発生するイベントを処理するために使用されます。このイベントは、カーソルがウィジェット領域に入ったとき (HoverEnter)、ウィジェット領域から出たとき (HoverLeave)、またはウィジェット領域内を移動したとき (HoverMove) に発生します。

QHoverEvent クラスの主な機能

• ポインティングデバイスの取得: device() メソッドを使用して、イベントを発生させたポインティングデバイスを取得できます。
• キーボード修飾子の取得: modifiers() メソッドを使用して、イベント発生時の押されているキーボード修飾子を取得できます。
• イベントの種類の取得: type() メソッドを使用して、イベントの種類 (HoverEnter、HoverLeave、または HoverMove) を取得できます。
• 以前のカーソル位置の取得: oldPos() メソッドを使用して、イベントが発生する前のカーソル位置を取得できます。
• カーソル位置の取得: pos() メソッドを使用して、現在のカーソル位置を取得できます。

QHoverEvent クラスの使用方法

以下は、QHoverEvent クラスを使用してカーソル位置をログに記録する簡単な例です。

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

protected:
    void enterEvent(QEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover enter: " << hoverEvent->pos();
    }

    void leaveEvent(QEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover leave: " << hoverEvent->pos();
    }

    void mouseMoveEvent(QMouseEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover move: " << hoverEvent->pos();
    }
};

• QHoverEvent クラスは、Qt 5.7 以降で使用できます。
• QHoverEvent クラスは、カーソルの移動を追跡するために使用できますが、クリックなどの他のマウスイベントを処理するためには使用できません。

---

#include <QApplication>
#include <QLabel>

class MyWidget : public QLabel {
public:
    MyWidget(const QString &text, QWidget *parent = nullptr) : QLabel(text, parent) {}

protected:
    void enterEvent(QEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover enter: " << hoverEvent->pos();
        palette().setColor(QPalette::Base, QColor(Qt::red));
        update();
    }

    void leaveEvent(QEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover leave: " << hoverEvent->pos();
        palette().setColor(QPalette::Base, QColor(Qt::white));
        update();
    }

    void mouseMoveEvent(QMouseEvent *event) override {
        QHoverEvent *hoverEvent = static_cast<QHoverEvent *>(event);
        qDebug() << "Hover move: " << hoverEvent->pos();
    }
};

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

    MyWidget widget("Hover me!");
    widget.show();

    return app.exec();
}

このコードを実行すると、ウィジェットの上にマウスカーソルを移動すると、ウィジェットの背景色が赤色に変わります。カーソルをウィジェットから離すと、背景色が白色に戻ります。

---

QHoverEvent クラスの代替方法

• マウス移動イベント (QMouseEvent): カーソルがウィジェットの上を移動したときに発生するすべてのマウスイベントを処理したい場合は、QMouseEvent クラスを使用できます。QMouseEvent クラスは、QHoverEvent クラスよりも多くの情報 (ボタンの押下状況、スクロール量など) を提供します。

void mouseMoveEvent(QMouseEvent *event) override {
    // カーソル位置を取得
    QPoint pos = event->pos();

    // 処理を行う
    // ...
}

• タイマー: カーソルがウィジェットの上を一定時間以上滞在しているかどうかを判断したい場合は、タイマーを使用できます。

QTimer timer;

void enterEvent(QEvent *event) override {
    // タイマーを開始
    timer.start(1000); // 1秒後に timeout() シグナルを発行
}

void leaveEvent(QEvent *event) override {
    // タイマーを停止
    timer.stop();
}

void timeout() {
    // カーソルがウィジェットの上を 1 秒以上滞在している
    // 処理を行う
    // ...
}

• カスタムイベント: 独自のイベントを定義して、カーソルがウィジェットの上を移動したことを通知したい場合は、カスタムイベントを使用できます。

class MyHoverEvent : public QEvent {
public:
    MyHoverEvent(const QPointF &pos) : QEvent(Type::MyHoverEvent), pos(pos) {}

    QPointF pos;
};

void enterEvent(QEvent *event) override {
    // カスタムイベントを発行
    QCoreApplication::instance()->postEvent(this, new MyHoverEvent(event->pos()));
}

bool event(QEvent *event) override {
    if (event->type() == MyHoverEvent::Type::MyHoverEvent) {
        MyHoverEvent *hoverEvent = static_cast<MyHoverEvent *>(event);

        // カーソル位置を取得
        QPointF pos = hoverEvent->pos;

        // 処理を行う
        // ...

        return true;
    }

    return QObject::event(event);
}

どの方法を使用すべきか

どの方法を使用するかは、状況によって異なります。

• 独自のイベントを定義したい場合: カスタムイベントを使用する必要があります。
• カーソルがウィジェットの上を一定時間以上滞在しているかどうかを判断したい場合: タイマーを使用する必要があります。
• より多くの情報が必要な場合: カーソル位置だけでなく、ボタンの押下状況やスクロール量などの情報が必要な場合、QMouseEvent クラスを使用する必要があります。
• シンプルで汎用的な方法: カーソル位置を取得して簡単な処理を行うだけの場合、QHoverEvent クラスを使用するのが最も簡単です。