QHoverEvent 類

The QHoverEvent 類包含鼠標事件的描述參數。 更多...

頭: #include <QHoverEvent>
qmake: QT += gui
繼承: QInputEvent

公共函數

QHoverEvent (Type type , const QPointF & pos , const QPointF & oldPos , Qt::KeyboardModifiers modifiers = Qt::NoModifier)
QPoint oldPos () const
const QPointF & oldPosF () const
QPoint pos () const
const QPointF & posF () const

額外繼承成員

詳細描述

The QHoverEvent 類包含鼠標事件的描述參數。

齣現鼠標事件,當鼠標光標移入/移齣 Widget,或在 Widget 內移動時,且若小部件擁有 Qt::WA_Hover 屬性。

函數 pos () 給齣當前光標位置,而 oldPos () 給齣舊鼠標位置。

有一些相似介於事件 QEvent::HoverEnter and QEvent::HoverLeave ,和事件 QEvent::Enter and QEvent::Leave 。不管怎樣,它們略有不同,因為會進行 update() 在事件處理程序 HoverEnter and HoverLeave .

QEvent::HoverMove 也稍微不同於 QEvent::MouseMove 。讓我們考慮頂層窗口 A 包含子級 B,而 B 依次包含子級 C (都有啓用鼠標追蹤):

現在,若將光標從 A 中間的頂部移到底部,將獲得下列 QEvent::MouseMove 事件:

  1. A::MouseMove
  2. B::MouseMove
  3. C::MouseMove

將獲得相同事件 QEvent::HoverMove ,除事件始終會被傳播給頂層外,不管事件是否被接受。它纔會停止傳播采用 Qt::WA_NoMousePropagation 屬性。

在此情況下,事件將按下列方式齣現:

  1. A::HoverMove
  2. A::HoverMove, B::HoverMove
  3. A::HoverMove, B::HoverMove, C::HoverMove

成員函數文檔編製

QHoverEvent:: QHoverEvent ( Type type , const QPointF & pos , const QPointF & oldPos , Qt::KeyboardModifiers modifiers = Qt::NoModifier)

構造懸停事件對象。

The type 參數必須是 QEvent::HoverEnter , QEvent::HoverLeave ,或 QEvent::HoverMove .

The pos 是相對於接收 Widget 的當前鼠標光標位置,而 oldPos 是它的先前這種位置。 modifiers 保持事件發生時所有鍵盤修飾符的狀態。

QPoint QHoverEvent:: oldPos () const

返迴鼠標光標的先前位置,相對接收事件 Widget。若沒有先前位置,oldPos() 將返迴相同位置如 pos ().

On QEvent::HoverEnter 事件,此位置將始終是 QPoint (-1, -1).

另請參閱 pos ().

const QPointF &QHoverEvent:: oldPosF () const

返迴鼠標光標的先前位置,相對接收事件 Widget。若沒有先前位置,oldPosF() 將返迴相同位置如 posF ().

On QEvent::HoverEnter 事件,此位置將始終是 QPointF (-1, -1).

另請參閱 posF ().

QPoint QHoverEvent:: pos () const

返迴鼠標光標的位置,相對於接收事件的 Widget。

On QEvent::HoverLeave 事件,此位置將始終是 QPoint (-1, -1).

另請參閱 oldPos ().

const QPointF &QHoverEvent:: posF () const

返迴鼠標光標的位置,相對於接收事件的 Widget。

On QEvent::HoverLeave 事件,此位置將始終是 QPointF (-1, -1).

另請參閱 oldPosF ().