QScroller Class

已于 2024-10-13 15:27:09 修改
阅读量779 收藏 16
点赞数 23
分类专栏： Qt Widgets 文章标签： qt c++
于 2024-10-11 17:16:46 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43446462/article/details/142858070
版权

Header：#include < QScroller >
qmake：QT += widgets
Since：Qt 5.0
Inherits：QObject

This class was introduced in Qt 5.0.

Public Types

enum Input { InputPress, InputMove, InputRelease }
enum ScrollerGestureType { TouchGesture, LeftMouseButtonGesture, MiddleMouseButtonGesture, RightMouseButtonGesture }
enum State { Inactive, Pressed, Dragging, Scrolling }

Properties

scrollerProperties : QScrollerProperties
state : const State

Public Functions

QPointF finalPosition() const
bool handleInput(QScroller::Input input, const QPointF &position, qint64 timestamp = 0)
QPointF pixelPerMeter() const
QScrollerProperties scrollerProperties() const
void setSnapPositionsX(const QList<qreal> &positions)
void setSnapPositionsX(qreal first, qreal interval)
void setSnapPositionsY(const QList<qreal> &positions)
void setSnapPositionsY(qreal first, qreal interval)
QScroller::State state() const
void stop()
QObject *target() const
QPointF velocity() const

Public Slots

void ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime)
void ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin)
void resendPrepareEvent()
void scrollTo(const QPointF &pos, int scrollTime)
void scrollTo(const QPointF &pos)
void setScrollerProperties(const QScrollerProperties &prop)

Signals

void scrollerPropertiesChanged(const QScrollerProperties &newProperties)
void stateChanged(QScroller::State newState)

Static Public Members

QList<QScroller *> activeScrollers()
Qt::GestureType grabGesture(QObject *target, QScroller::ScrollerGestureType scrollGestureType = TouchGesture)
Qt::GestureType grabbedGesture(QObject *target)
bool hasScroller(QObject *target)
QScroller *scroller(QObject *target)
const QScroller *scroller(const QObject *target)
void ungrabGesture(QObject *target)

Detailed Description

使用动态滚动，用户可以向给定方向推动小部件，它将继续沿着该方向滚动，直到被用户或摩擦停止。可以改变惯性、摩擦和其他物理概念，以微调直观的用户体验。
qscroll对象是存储当前位置和滚动速度并负责更新的对象。qscroll可以通过轻击手势触发

QWidget *w = ...;
QScroller::grabGesture(w, QScroller::LeftMouseButtonGesture);

或者直接像这样:

QWidget *w = ...;
QScroller *scroller = QScroller::scroller(w);
scroller->scrollTo(QPointF(100, 100));

滚动的QObjects在滚动需要更新其几何信息时接收一个QScrollPrepareEvent，在对象的内容需要实际滚动时接收一个QScrollEvent。
滚轮使用全局的QAbstractAnimation计时器来生成它的QScrollEvents。这可以在每个qscroll的基础上使用QScrollerProperties::FrameRate进行更改。
滚动示例目录中的几个示例展示了如何使用QScroller、QScrollEvent和滚动手势。
尽管这个动态滚轮通过QScrollerProperties有大量可用的设置，我们建议您将它们全部保留为默认的平台优化值。在更改它们之前，您可以在滚动示例目录中试用绘图示例。
See also QScrollEvent, QScrollPrepareEvent, and QScrollerProperties.

Member Type Documentation

enum QScroller::Input
该枚举包含与qroller相关的输入事件的输入设备无关视图。
ConstantValueDescription
QScroller::InputPress1The user pressed the input device (e.g. QEvent::MouseButtonPress, QEvent::GraphicsSceneMousePress, QEvent::TouchBegin)
QScroller::InputMove2The user moved the input device (e.g. QEvent::MouseMove, QEvent::GraphicsSceneMouseMove, QEvent::TouchUpdate)
QScroller::InputRelease3The user released the input device (e.g. QEvent::MouseButtonRelease, QEvent::GraphicsSceneMouseRelease, QEvent::TouchEnd)
enum QScroller::ScrollerGestureType
此枚举包含qscroll手势识别器支持的不同手势类型。
ConstantValueDescription
QScroller::TouchGesture0手势识别器只会在触摸事件时触发。具体来说，当使用触摸屏时，它会在单触点上做出反应，当使用触摸板时，它会在双触点上做出反应。
QScroller::LeftMouseButtonGesture1手势识别器只会触发鼠标左键事件。
QScroller::MiddleMouseButtonGesture3手势识别器只会在鼠标中键事件时触发。
QScroller::RightMouseButtonGesture2手势识别器只会在鼠标右键事件时触发。
enum QScroller::State
此枚举包含不同的qscroll状态。
ConstantValueDescription
QScroller::Inactive0滚轮没有滚动，也没有按下任何东西。
QScroller::Pressed1收到触摸事件或按下鼠标按钮，但滚动区域当前未被拖动。
QScroller::Dragging2滚动区域当前跟随触摸点或鼠标。
QScroller::Scrolling3滚动区域会自己移动。

Property Documentation

scrollerProperties : QScrollerProperties
	此属性保存此滚轮的滚轮属性。QScroller使用这些属性来确定其滚动行为。
访问函数：
	QScrollerProperties scrollerProperties() const
	void setScrollerProperties(const QScrollerProperties &prop)
通知信号：
	void scrollerPropertiesChanged(const QScrollerProperties &newProperties)

state : const State
	此属性保存滚轮的状态
访问函数：
	QScroller::State state() const
通知信号：
	void stateChanged(QScroller::State newState)

See also QScroller::State.

Member Function Documentation

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime)
	这是一个重载函数。
	此版本将在scrollTime毫秒内到达目标位置。

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin)
	开始滚动，使矩形矩形在视口中可见，并在矩形周围使用xmargin和ymargin以像素指定附加边距。
	如果在viewport内不可能匹配rect +边距，则滚动内容，以便尽可能多地从rect可见。
	计算滚动速度，以便在平台定义的时间跨度之后到达给定位置。
	这个函数通过调用scrollTo()来执行实际的滚动操作。
See also scrollTo().

[slot] void QScroller::resendPrepareEvent()
	这个函数重新发送QScrollPrepareEvent。调用resendPrepareEvent从滚动轮触发QScrollPrepareEvent。
这允许接收者在滚动时重新设置内容位置和内容大小。
在Inactive状态下调用此函数是无用的，因为在滚动开始之前会再次发送prepare事件。

[slot] void QScroller::scrollTo(const QPointF &pos, int scrollTime)
	这是一个重载函数。
	此版本将在scrollTime毫秒内到达目标位置。

[slot] void QScroller::scrollTo(const QPointF &pos)
	开始滚动小部件，使点pos位于视口的左上角。
	在有效滚动区域之外滚动时的行为是未定义的。在这种情况下，滚轮可能会或不会超调。
	将计算滚动速度，以便在平台定义的时间跨度之后到达给定位置。
	Pos在视口坐标中给出。
	
See also ensureVisible().

[signal] void QScroller::scrollerPropertiesChanged(const QScrollerProperties &newProperties)
	每当它的滚轮属性改变时，QScroller都会发出这个信号。newProperties是新的滚动条属性。
	注意:属性scrollerProperties的通知器信号。

See also scrollerProperties.

[signal] void QScroller::stateChanged(QScroller::State newState)
	每当状态改变时，qscroll都会发出这个信号。newState是新的State。
	注意:属性状态的通知器信号。

See also state.

[static] QList<QScroller *> QScroller::activeScrollers()
	返回当前活动qscroll对象的应用程序范围列表。活动QScroller对象处于非QScroller::Inactive状态()。这个函数在编写自己的手势识别器时非常有用。

QPointF QScroller::finalPosition() const
	返回当前滚动移动的估计最终位置。如果滚轮状态不是滚动状态，则返回当前位置。当滚动条状态为Inactive时，结果是未定义的。
	目标位置以像素为单位。

See also pixelPerMeter() and scrollTo().

[static] Qt::GestureType QScroller::grabGesture(QObject *target, QScroller::ScrollerGestureType scrollGestureType = TouchGesture)
	注册一个自定义滚动手势识别器，为目标获取它并返回结果手势类型。如果scrollGestureType被设置为TouchGesture，手势会触发触摸事件。如果它被设置为LeftMouseButtonGesture, RightMouseButtonGesture或MiddleMouseButtonGesture中的一个，它将触发相应按钮的鼠标事件。
	同一时间，一个对象上只能激活一个滚动手势。如果在同一个对象上调用此函数两次，它将在抓取新手势之前取消抓取现有手势。
	注意:为了避免不必要的副作用，在触发手势时消耗鼠标事件。由于初始的鼠标按下事件没有被消耗，手势在全局位置(INT_MIN, INT_MIN)发送一个假的鼠标释放事件。这确保了接收到原始鼠标按压的小部件的内部状态是一致的。
See also ungrabGesture() and grabbedGesture().

[static] Qt::GestureType QScroller::grabbedGesture(QObject *target)
	返回当前为目标抓取的手势类型，如果没有抓取手势则返回0。

See also grabGesture() and ungrabGesture().

bool QScroller::handleInput(QScroller::Input input, const QPointF &position, qint64 timestamp = 0)
	这个函数被手势识别器用来通知滚轮一个新的输入事件。滚动条根据输入事件及其附加的滚动条属性改变其内部状态()。滚轮无法区分事件来自哪一种输入设备。因此，需要将事件拆分为输入类型、位置和毫秒时间戳。这个位置需要在目标的坐标系中。
	如果事件应由调用过滤器使用，则返回值为true;如果事件应转发到控件，则返回值为false。
	注意:对于大多数用例，使用grabGesture()应该是足够的。

[static] bool QScroller::hasScroller(QObject *target)
	如果QScroller对象已经为target创建，则返回true;否则错误。

See also scroller().

QPointF QScroller::pixelPerMeter() const
	返回滚动小部件的每米像素度量。
	通过使用QPointF分别报告x轴和y轴的值。
	注意:请注意，此值应在物理上正确。Qt为显示返回的实际DPI设置可能被底层窗口系统故意错误地报告，例如在macOS上。

[static] QScroller *QScroller::scroller(QObject *target)
	返回给定目标的滚轮。只要对象存在，此函数将始终返回相同的qroller实例。如果目标不存在qscroll，则将隐式地创建一个。在任何情况下，一个对象上都不能有多个qscroll处于活动状态。
See also hasScroller() and target().

[static] const QScroller *QScroller::scroller(const QObject *target)
	这是一个重载函数。
	这是scroller()的const版本。

void QScroller::setSnapPositionsX(const QList<qreal> &positions)
	将水平轴的快照位置设置为位置列表。这将覆盖所有先前设置的捕获位置以及先前设置的捕获间隔。可以通过设置一个空的位置列表来禁用捕捉。

void QScroller::setSnapPositionsX(qreal first, qreal interval)
	将水平轴的快照位置设置为规则间隔。第一个抓拍位置是在第一。
下一个在第一个+间隔。这可以用来实现一个列表头。
这将覆盖所有先前设置的捕获位置以及先前设置的捕获间隔。可以通过将间隔设置为0.0来停用捕捉

void QScroller::setSnapPositionsY(const QList<qreal> &positions)
	将垂直轴的快照位置设置为位置列表。
这将覆盖所有先前设置的捕获位置以及先前设置的捕获间隔。
可以通过设置一个空的位置列表来禁用捕捉。

void QScroller::setSnapPositionsY(qreal first, qreal interval)
	将垂直轴的快照位置设置为规则间隔。第一个抓拍位置是在第一。
下一个在第一个+间隔。这将覆盖所有先前设置的捕获位置以及先前设置的捕获间隔。
可以通过将间隔设置为0.0来停用捕捉

void QScroller::stop()
	停止滚轮并将其状态重置为非活动状态。

QObject *QScroller::target() const
	返回此滚轮的目标对象。
See also hasScroller() and scroller().

[static] void QScroller::ungrabGesture(QObject *target)
	松开目标的手势。如果没有手势被抓取，则不执行任何操作。
See also grabGesture() and grabbedGesture().

QPointF QScroller::velocity() const
	当状态为“滚动”或“拖动”时，返回当前以米/秒为单位的滚动速度。否则返回零速度。
	通过使用QPointF分别报告x轴和y轴的速度。
See also pixelPerMeter().
3class3class
09-09
3class3class
QT开发教程：QScroller实现home界面滑动效果
m0_60259116的博客
11-28 1798
QT开发教程：QScroller实现home界面滑动效果
Qt 触屏实现滑屏效果
danshiming的博客
05-10 3156
触屏实现滑屏效果
QT QScroller拖拽使用方法
wuyu92877的专栏
01-04 1781
在开发中遇到QListWidget 实现拖拽的回弹效果，拖拽的距离太大，修改拖拽的距离 继承QListWidget QScroller *scroller; QScrollerPropertiesscrPrt ; ListWidget::ListWidget(QWidget *parent) :QListWidget(parent) { scroller = QScroller::scroller(this) //创建scroller； scroller->grab...
使用QScroller导致滚动条QScrollBar无法使用
城域
04-14 1473
如下，虽然可以实现鼠标拖动，但滚动条也会触发拖动效果。 QScrollArea *scrollArea = new QScrollArea(this); QScroller::grabGesture(scrollArea, QScroller::LeftMouseButtonGesture) ; 修改scrollArea为scrollArea->viewport() 。 ...
白鹭 egret 滚动容器(Scroller)中的输入框(input)无法获取焦点问题
PlayboyBoZhao的博客
09-26 968
解决方法 //当input 被点击的时候 手动获取 input 的焦点.setFocus() this.input.addEventListener(egret.TouchEvent.TOUCH_TAP, () => { this.input.textDisplay.setFocus(); }, this); ...
QT的QScroller类的使用
希望我的博客，能帮上你解决学习中工作中所遇到的问题
12-24 2845
详细说明 QScroller类为任何滚动小部件或图形项启用动态滚动。 通过动态滚动，用户可以沿给定方向推动窗口小部件，并且窗口小部件将继续沿该方向滚动，直到它被用户或摩擦停止。可以更改惯性，摩擦和其他物理概念的各个方面，以微调直观的用户体验。 QScroller对象是存储当前位置和滚动速度并负责更新的对象。轻拂手势即可触发QScroller QWidget *w = new QWidget ; QScroller::grabGesture(w, QScroller::LeftMous
LsyTest.class
11-30
生成的class文件，供反编译用 生成的class文件，供反编译用 生成的class文件，供反编译用 生成的class文件，供反编译用 生成的class文件，供反编译用
vue如何判断dom的class
08-27
Vue 中判断 DOM 的 class 在 Vue 中判断 DOM 的 class 是一个常见的需求，今天我们将通过一个实例来介绍如何判断 DOM 的 class。在这个实例中，我们将使用 Vue 框架来实现点击给 DOM 添加 class，然后获取含有 ...
setAttribute 与 class冲突解决
09-06
在 Firefox 中，使用 setAttribute("class","red") 可以正确地设置元素的 class 属性，而在 IE 中，使用 setAttribute("class","red") 将导致元素上显示两个 class 属性，这是因为 IE 浏览器将自定义的 class 和系统...
Class文件结构
04-23
主要内容包含Class文件的组成要素，魔数，版本号，常量池等内容
QtWebServer
大AI时代，人性化的信息更加难得可贵
11-11 412
在 Qt 应用程序中，您可以设置资源并将其绑定到物理提供程序，例如文件或数据库内容。Web 应用程序对象包含有关如何将 uri 模式与资源匹配的信息，该信息同样由多线程 tcp 服务器组件访问。多线程服务器是 Qt 的 QTcpServer 类的扩展。QtWebServer 是创建基于 Qt 的高性能 Web 应用程序服务器的尝试，即。运行本机 C++/Qt 代码以交付网站的 Web 服务器。参考：https://github.com/jacob3141/qtwebserver。
QT之QML从入门到精通（第五章）
m0_58233509的博客
11-10 304
y:100delegate: ItemDelegate { //针对model每一个项的具体绘制"red":"blue" //下拉框每一个项为红色// indicator: Canvas { //右侧的下拉箭头绘制，使用画布，也可以之间使用image控件// }// }// }contentItem: Text { //控制当前控件的显示内容"red" : "blue" //不安下是蓝色，按下红色。
[241110] 微软发布多智能体系统Magentic-One | 社区讨论:Ubuntu 26.04 LTS 发布前移除 Qt 5
edwinjhlee的博客
11-10 1029
- 微软发布多智能体系统 Magentic-One - 社区讨论:Ubuntu 26.04 LTS 发布前移除 Qt 5
认识QT以及QT的环境搭建
m0_74099572的博客
11-11 988
Qt ⽀持多种开发⼯具，其中⽐较常⽤的开发⼯具有：Qt Creator、Visual Studio、Eclipse.其中：Qt Creator是官网提供的开发QT的IDE，这种对新手也比较友好，后续我们以Qt Creator演示为主Visual Studio开发QT功能强大，但是前期的配置比较麻烦，作为新手还是不太推荐。Eclipse现在已经停止维护了，不如前两种。关于QT的开发环境需要三个部分：1.一个C++编译器，这里的编译器是指gcc这种，不是指。
Qt 正则表达式提取文件中的 USB 设备 ID
最新发布
二分掌柜的
11-12 385
Qt
Qt 练习做一个登录界面
StevenChen的博客
11-02 1290
练习做一个登录界面
【Qt聊天室客户端】登录窗口
gma999的博客
11-10 497
客户单登录窗口功能的实现
Java运行时类型信息：Class类详解
"Java的Class类是用于在运行时表示类和接口的元数据，它提供了访问和操作类信息的各种方法。" Java的`Class`类是Java反射机制的核心，它允许程序在运行时动态获取类的信息并进行操作。以下是对`Class`类及其相关...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值