WheelEvent QML 类型
提供有关鼠标滚轮事件的信息。 更多...
导入语句 | import QtQuick |
属性
- accepted : bool
- angleDelta : point
- buttons : int
- inverted : bool
- modifiers : int
- pixelDelta : point
- x : real
- y : real
详细说明
另请参阅WheelHandler 和 MouseArea。
属性文档
这些属性包含由滚轮事件提供的位置的坐标。
accepted : bool |
将 accepted 设置为 true
可防止将轮事件传播到接收项或处理程序以下的项。
通常,如果项对轮事件进行了处理,则应接受它,以便堆叠顺序较低的项不会对该事件做出响应。
angleDelta : point |
此属性包含滚轮旋转的相对量,以八分之一度为单位。此属性的 x
和 y
坐标分别表示水平和垂直方向的变化。
正值表示滚轮向上/向右旋转;负值表示滚轮向下/向左旋转。
大多数鼠标类型以 15
度的步长工作,在这种情况下,差值是一个 120
的倍数;即 120 单位 * 1/8 = 15 度
。
buttons : int |
inverted : bool |
返回事件传递的增量值是否已反转。
通常,垂直滚轮如果滚轮顶部远离操作它的人旋转,将产生带有正增量值的WheelEvent。类似地,如果将滚轮顶部向左移动,水平滚轮移动将产生带有正增量值的QWheelEvent。
但是,在某些平台上,这可以配置,因此上述相同操作将产生负增量值(但幅度相同)。例如,在一个QML组件(例如旋钮或滑块)中,如果在与系统设置无关的情况下,适当同步项目移动或旋转与滚轮的方向,则可以 wheel 事件处理程序使用 inverted 属性来决定是否取反angleDelta 或 pixelDelta 值.
注意:许多平台不提供此类信息。在这些平台上,inverted
总是返回 false
。
modifiers : int |
此属性包含事件发生前立即存在的键盘修饰符标志。
它包含一个位运算组合
- Qt.NoModifier - 没有按修饰符键。
- Qt.ShiftModifier - 打击了键盘上的 Shift 键。
- Qt.ControlModifier - 打击了键盘上的 Ctrl 键。
- Qt.AltModifier - 打击了键盘上的 Alt 键。
- Qt.MetaModifier - 打击了键盘上的 Meta 键。
- Qt.KeypadModifier - 按击了键盘上的数字键盘按钮。
例如,为对车轮事件过程中的 Control 键按下做出反应
WheelHandler { onWheel: (wheel)=> { if (wheel.modifiers & Qt.ControlModifier) { adjustZoom(wheel.angleDelta.y / 120); } } }
pixelDelta : point |
此属性包含屏幕像素增量,并且适用于具有高分辨率跟踪板的平台,例如 macOS。此属性的 x
和 y
坐标分别表示水平方向和垂直方向的增量。可以直接使用这些值在屏幕上滚动内容。
对于没有高分辨率跟踪板支持的平台,pixelDelta 将始终是 (0,0)
,应使用angleDelta 代替。
© 2024 Qt 公司有限。此处包含的文档贡献是各自所有者的版权。此处提供的文档是根据由自由软件基金会发布的GNU 自由文档许可版本 1.3 的条款提供的。Qt 以及相应的徽标是芬兰及其它在世界各地的 Qt 公司的商标。所有其他商标均为其各自所有者的财产。