QHoverEvent Class
QHoverEvent クラスには、マウスイベントを表すパラメータが含まれています。詳細...
| ヘッダー: | #include <QHoverEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | QSinglePointEvent |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- 非推奨のメンバ
- QHoverEvent はイベントクラスの一部です。
パブリック関数
| QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QPoint | oldPos() const |
| QPointF | oldPosF() const |
プロテクトされた関数
| QHoverEvent(QHoverEvent &&) | |
| QHoverEvent & | operator=(QHoverEvent &&) |
| QHoverEvent & | operator=(const QHoverEvent &other) |
詳細な説明
マウスイベントは、マウスカーソルがウィジェットの範囲内に入ったり、範囲外に出たり、範囲内で移動したりしたときに発生します。ただし、そのウィジェットにQt::WA_Hover 属性が設定されている場合に限ります。
関数position() は現在のカーソル位置を返し、oldPos() は以前のマウス位置を返します。
QEvent::HoverEnter およびQEvent::HoverLeave イベントと、QEvent::Enter およびQEvent::Leave イベントの間には、いくつかの類似点があります。ただし、HoverEnter および HoverLeave のイベントハンドラ内で update() を実行するため、これらはわずかに異なります。
QEvent::HoverMove QEvent::MouseMove とも若干異なります。トップレベルのウィンドウ A に子ウィンドウ B が含まれ、さらにその中に子ウィンドウ C が含まれている場合(すべてマウス追跡が有効になっている)を考えてみましょう:

ここで、Aの中央でカーソルを上から下へ移動させると、次のようなQEvent::MouseMove イベントが発生します:
- A::MouseMove
- B::MouseMove
- C::MouseMove
QEvent::HoverMove の場合も同様のイベントが発生しますが、イベントが受け入れられたかどうかにかかわらず、イベントは常にトップレベルまで伝播します。伝播が停止するのは、Qt::WA_NoMousePropagation 属性が設定されている場合のみです。
この場合、イベントは次のように発生します:
- A::HoverMove
- A::HoverMove、B::HoverMove
- A::HoverMove、B::HoverMove、C::HoverMove
メンバ関数のドキュメント
QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
device を起点とするホバーイベントオブジェクトを作成します。
type パラメータは、QEvent::HoverEnter 、QEvent::HoverLeave 、またはQEvent::HoverMove のいずれかでなければなりません。
scenePos は、受信側のウィンドウまたはシーンに対する現在のマウスカーソルの位置、oldPos はその直前の位置、globalPos は絶対座標でのマウス位置を表します。modifiers には、イベント発生時点でのすべてのキーボード修飾キーの状態が格納されます。
[protected delete] QHoverEvent::QHoverEvent(QHoverEvent &&)
QHoverEvent のインスタンスをMoveコンストラクタで生成します。この関数は削除されています。
QPoint QHoverEvent::oldPos() const
イベントを受け取ったウィジェットを基準として、マウスカーソルの直前の位置を返します。直前の位置が存在しない場合、oldPos() はposition() と同じ位置を返します。
QEvent::HoverEnter イベントでは、この位置は常にQPoint (-1, -1)となります。
position()も参照してください 。
QPointF QHoverEvent::oldPosF() const
イベントを受け取ったウィジェットを基準として、マウスカーソルの直前の位置を返します。直前の位置が存在しない場合、oldPosF() はposition() と同じ位置を返します。
QEvent::HoverEnter イベントでは、この位置は常にQPointF (-1, -1)となります。
position()も参照してください 。
[protected delete] QHoverEvent &QHoverEvent::operator=(QHoverEvent &&)
other をこのQHoverEvent インスタンスに割り当てます。この関数は削除されます。
[noexcept protected default] QHoverEvent &QHoverEvent::operator=(const QHoverEvent &other)
other をこのQHoverEvent インスタンスにコピーして割り当てます。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.