The QWheelEvent 類包含滾輪事件的描述參數。 更多...
| 頭： | #include <QWheelEvent> |
| qmake: | QT += gui |
| 繼承： | QInputEvent |
| QWheelEvent (const QPointF & pos , const QPointF & globalPos , QPoint pixelDelta , QPoint angleDelta , int qt4Delta , Qt::Orientation qt4Orientation , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers ) | |
| QWheelEvent (const QPointF & pos , const QPointF & globalPos , QPoint pixelDelta , QPoint angleDelta , int qt4Delta , Qt::Orientation qt4Orientation , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers , Qt::ScrollPhase phase ) | |
| QWheelEvent (const QPointF & pos , const QPointF & globalPos , QPoint pixelDelta , QPoint angleDelta , int qt4Delta , Qt::Orientation qt4Orientation , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers , Qt::ScrollPhase phase , Qt::MouseEventSource source ) | |
| QWheelEvent (const QPointF & pos , const QPointF & globalPos , QPoint pixelDelta , QPoint angleDelta , int qt4Delta , Qt::Orientation qt4Orientation , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers , Qt::ScrollPhase phase , Qt::MouseEventSource source , bool inverted ) | |
| QWheelEvent (QPointF pos , QPointF globalPos , QPoint pixelDelta , QPoint angleDelta , Qt::MouseButtons buttons , Qt::KeyboardModifiers modifiers , Qt::ScrollPhase phase , bool inverted , Qt::MouseEventSource source = Qt::MouseEventNotSynthesized) | |
| QPoint | angleDelta () const |
| Qt::MouseButtons | buttons () const |
| QPoint | globalPos () const |
| const QPointF & | globalPosF () const |
| int | globalX () const |
| int | globalY () const |
| bool | inverted () const |
| Qt::ScrollPhase | phase () const |
| QPoint | pixelDelta () const |
| QPoint | pos () const |
| const QPointF & | posF () const |
| Qt::MouseEventSource | source () const |
| int | x () const |
| int | y () const |
| uint | _unused_ |
| QPoint | angleD |
| QPointF | g |
| bool | invertedScrolling |
| Qt::MouseButtons | mouseState |
| QPointF | p |
| uint | ph |
| QPoint | pixelD |
| int | qt4D |
| Qt::Orientation | qt4O |
| int | reserved |
| uint | src |
The QWheelEvent 類包含滾輪事件的描述參數。
滾輪事件會被發送給鼠標光標下 Widget，但若該小部件不處理事件，它們會被發送給聚焦小部件。鼠標滾輪和觸摸闆捲動手勢都會生成滾輪事件。有 2 種方式能讀取滾輪事件增量： angleDelta () 返迴滾輪增量以度為單位。始終提供此值。 pixelDelta () returns the delta in screen pixels and is available on platforms that have high-resolution trackpads, such as macOS . If that is the case, source () 會返迴 Qt::MouseEventSynthesizedBySystem .
函數 pos () 和 globalPos () 返迴事件齣現時鼠標光標位置。
滾輪事件包含指示接收者是否想要事件的，特殊接受標誌。應該調用 ignore () 若不處理滾輪事件；這確保它會被發送給父級 Widget。
The QWidget::setEnabled () 函數可用於啓用 (或禁用) 小部件的鼠標事件和鍵盤事件。
事件處理程序 QWidget::wheelEvent () 接收滾輪事件。
另請參閱 QMouseEvent and QWidget::grabMouse ().
構造滾輪事件對象。
The pos 提供窗口中鼠標光標的位置。在全局坐標中位置的指定是通過 globalPos .
pixelDelta 包含以像素為單位的屏幕捲動距離，而 angleDelta 包含滾輪鏇轉距離。 pixelDelta 可選且可以是 null。
事件發生時的鼠標和鍵盤狀態的指定是通過 buttons and modifiers .
為嚮後兼容，事件還可以保持單嚮滾輪事件數據： qt4Delta 指定鏇轉，和 qt4Orientation 方嚮。
The phase () 被初始化為 Qt::ScrollUpdate 。使用其它構造函數明確指定階段。
另請參閱 posF (), globalPosF (), angleDelta ()，和 pixelDelta ().
構造滾輪事件對象。
The pos 提供窗口中鼠標光標的位置。在全局坐標中位置的指定是通過 globalPos .
pixelDelta 包含以像素為單位的屏幕捲動距離，而 angleDelta 包含滾輪鏇轉距離。 pixelDelta 可選且可以是 null。
事件發生時的鼠標和鍵盤狀態的指定是通過 buttons and modifiers .
為嚮後兼容，事件還可以保持單嚮滾輪事件數據： qt4Delta 指定鏇轉，和 qt4Orientation 方嚮。
事件捲動階段的指定是通過 phase .
另請參閱 posF (), globalPosF (), angleDelta (), pixelDelta ()，和 phase ().
構造滾輪事件對象。
The pos 提供窗口中鼠標光標的位置。在全局坐標中位置的指定是通過 globalPos .
pixelDelta 包含以像素為單位的屏幕捲動距離，而 angleDelta 包含滾輪鏇轉距離。 pixelDelta 可選且可以是 null。
事件發生時的鼠標和鍵盤狀態的指定是通過 buttons and modifiers .
為嚮後兼容，事件還可以保持單嚮滾輪事件數據： qt4Delta 指定鏇轉，和 qt4Orientation 方嚮。
事件捲動階段的指定是通過 phase .
若滾輪事件來自物理鼠標滾輪， source 被設為 Qt::MouseEventNotSynthesized 。若它來自由操作係統檢測到的手勢，或來自非鼠標硬件設備，譬如 pixelDelta 與手指運動直接相關， source 被設為 Qt::MouseEventSynthesizedBySystem 。若它來自 Qt，source 被設為 Qt::MouseEventSynthesizedByQt .
另請參閱 posF (), globalPosF (), angleDelta (), pixelDelta ()，和 phase ().
構造滾輪事件對象。
The pos 提供窗口中鼠標光標的位置。在全局坐標中位置的指定是通過 globalPos .
pixelDelta 包含以像素為單位的屏幕捲動距離，而 angleDelta 包含滾輪鏇轉距離。 pixelDelta 可選且可以是 null。
事件發生時的鼠標和鍵盤狀態的指定是通過 buttons and modifiers .
為嚮後兼容，事件還可以保持單嚮滾輪事件數據： qt4Delta 指定鏇轉，和 qt4Orientation 方嚮。
事件捲動階段的指定是通過 phase .
若滾輪事件來自物理鼠標滾輪， source 被設為 Qt::MouseEventNotSynthesized 。若它來自由操作係統檢測到的手勢，或來自非鼠標硬件設備，譬如 pixelDelta 與手指運動直接相關， source 被設為 Qt::MouseEventSynthesizedBySystem 。若它來自 Qt，source 被設為 Qt::MouseEventSynthesizedByQt .
若係統被配置為反轉隨事件交付的增量值 (譬如 OS X 觸摸闆的自然捲動)，
inverted
應該為
true
。否則，
inverted
is
false
另請參閱 posF (), globalPosF (), angleDelta (), pixelDelta ()，和 phase ().
構造滾輪事件對象。
The pos 提供窗口中鼠標光標的位置。在全局坐標中位置的指定是通過 globalPos .
pixelDelta 包含以像素為單位的屏幕捲動距離，而 angleDelta 包含滾輪鏇轉距離。 pixelDelta 可選且可以是 null。
事件發生時的鼠標和鍵盤狀態的指定是通過 buttons and modifiers .
事件捲動階段的指定是通過 phase .
若滾輪事件來自物理鼠標滾輪， source 被設為 Qt::MouseEventNotSynthesized 。若它來自由操作係統檢測到的手勢，或來自非鼠標硬件設備，譬如 pixelDelta 與手指運動直接相關， source 被設為 Qt::MouseEventSynthesizedBySystem 。若它來自 Qt，source 被設為 Qt::MouseEventSynthesizedByQt .
If the system is configured to invert the delta values delivered with the event (such as natural scrolling of the touchpad on
macOS
),
inverted
應該為
true
。否則，
inverted
is
false
另請參閱 posF (), globalPosF (), angleDelta (), pixelDelta ()，和 phase ().
返迴鏇轉滾輪的距離，以八分之一度為單位。正值指示滾輪嚮前鏇轉遠離用戶；負值指示滾輪嚮後鏇轉朝著用戶。
大多數鼠標類型以 15 度步幅為單位工作，在這種情況下，增量值是 120 的倍增 (即：120 單位 *1/8 = 15 度)。
不管怎樣，一些鼠標擁有更精細分辨率的滾輪，並發送小於 120 單位 (小於 15 度) 的增量值。要支持這種可能性，可以纍加來自事件的增量值，直到達到 120，然後捲動 Widget，或者，可以部分捲動小部件以響應各滾輪事件。
範例：
void MyWidget::wheelEvent(QWheelEvent *event) { QPoint numPixels = event->pixelDelta(); QPoint numDegrees = event->angleDelta() / 8; if (!numPixels.isNull()) { scrollWithPixels(numPixels); } else if (!numDegrees.isNull()) { QPoint numSteps = numDegrees / 15; scrollWithDegrees(numSteps); } event->accept(); }
注意： 當平颱支持捲動 phases ，增量可能為 null 當：
返迴事件齣現時的鼠標狀態。
返迴鼠標指針的全局位置 當事件發生時 。這對異步窗口係統 (譬如 X11) 很重要。每當圍繞響應鼠標事件移動 Widget 時，globalPos() 會非常不同於當前光標位置返迴通過 QCursor::pos ().
返迴鼠標指針的全局位置 當事件發生時 。這對異步窗口係統 (譬如 X11) 很重要。每當圍繞響應鼠標事件移動 Widget 時，globalPosF() 會非常不同於當前光標位置返迴通過 QCursor::pos ().
另請參閱 posF ().
返迴事件發生時的鼠標光標全局 X 位置。
另請參閱 globalY () 和 globalPos ().
返迴事件發生時的鼠標光標全局 Y 位置。
另請參閱 globalX () 和 globalPos ().
返迴隨事件交付的增量值是否反轉。
通常，垂直滾輪會産生 QWheelEvent 具有正增量值若滾輪頂部鏇轉離開操作它的手。同樣，水平滾輪運動會産生 QWheelEvent 具有正增量值若滾輪頂部嚮左移動。
不管怎樣，在某些平颱這是可配置的，因此如上述的相同操作會産生負增量值 (但幅度一樣)。利用反轉特性，滾輪事件消費者可以選擇始終跟隨滾輪方嚮，不管係統設置，但僅適用於特定 Widget (一種這樣的用例可能是用戶按如視覺 "Tumbler 轉盤" 鏇轉的相同方嚮鏇轉滾輪。另一用例是使滑動手柄跟隨觸摸闆上手指的移動方嚮，不管係統配置)。
注意： 很多平颱不提供這樣的信息。在這種平颱，inverted 始終返迴 false。
該函數在 Qt 5.7 引入。
返迴此滾輪事件的捲動階段。
注意： The Qt::ScrollBegin and Qt::ScrollEnd phases are currently supported only on macOS .
該函數在 Qt 5.2 引入。
Returns the scrolling distance in pixels on screen. This value is provided on platforms that support high-resolution pixel-based delta values, such as macOS . The value should be used directly to scroll content on screen.
範例：
void MyWidget::wheelEvent(QWheelEvent *event) { QPoint numPixels = event->pixelDelta(); QPoint numDegrees = event->angleDelta() / 8; if (!numPixels.isNull()) { scrollWithPixels(numPixels); } else if (!numDegrees.isNull()) { QPoint numSteps = numDegrees / 15; scrollWithDegrees(numSteps); } event->accept(); }
注意： 當平颱支持捲動 phases ，增量可能為 null 當：
注意： 在 X11，此值是驅動程序特定的且不可靠，使用 angleDelta () 代替
返迴相對於接收事件 Widget 的鼠標光標位置。
若圍繞響應鼠標事件移動 Widget，使用 globalPos () 而不是此函數。
另請參閱 x (), y ()，和 globalPos ().
返迴相對於接收事件 Widget 的鼠標光標位置。
若圍繞響應鼠標事件移動 Widget，使用 globalPosF () 而不是此函數。
另請參閱 globalPosF ().
返迴滾輪事件源的有關信息。
源可以用於區分來自具有物理滾輪的鼠標事件，和由某些其它手段 (例如在觸摸闆上輕彈手勢) 生成的事件。
注意： 很多平颱不提供這種信息。在這種平颱 Qt::MouseEventNotSynthesized 始終被返迴。
該函數在 Qt 5.5 引入。
另請參閱 Qt::MouseEventSource .
返迴相對於接收事件 Widget 的鼠標光標 X 位置。
返迴相對於接收事件 Widget 的鼠標光標 Y 位置。
