QHoverEvent 類

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

頭: #include <QHoverEvent>
繼承: QEvent

公共函數

QHoverEvent (Type type , const QPoint & pos , const QPoint & oldPos )
const QPoint & oldPos () const
const QPoint & pos () 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 QPoint & pos , const QPoint & oldPos )

構造懸停事件對象。

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

The pos 是相對於接收 Widget 的當前鼠標光標位置,而 oldPos is the previous mouse cursor's position relative to the receiving widget.

const QPoint & QHoverEvent:: oldPos () const

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

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

另請參閱 pos ().

const QPoint & QHoverEvent:: pos () const

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

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

另請參閱 oldPos ().