QScrollEvent 类

在滚动时发送 QScrollEvent 类。更多...

头文件	#include <QScrollEvent>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui
继承	QEvent

包含所有成员列表，包括继承的成员
QScrollEvent 是事件类的一部分.Event Classes.

公共类型

枚举	ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished }

公共函数

	QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)
QPointF	contentPos() const
QPointF	overshootDistance() const
QScrollEvent::ScrollState	scrollState() const

详细描述

滚动事件用于指示接收器应进行滚动。通常接收器应该是某种视觉元素，例如QWidget或QGraphicsObject。

应注意确保来自两个来源的QScrollEvent不会冲突。然而使用QScroller::scrollTo是安全的。

另请参阅 QScrollPrepareEvent和QScroller。

成员类型文档

枚举 QScrollEvent::ScrollState

此枚举描述了滚动事件可能的状态。

常量	值	描述
`QScrollEvent::ScrollStarted`	`0`	用于滚动活动的第一个滚动事件。
`QScrollEvent::ScrollUpdated`	`1`	用于除第一个和最后一个滚动事件之外的所有滚动事件。
`QScrollEvent::ScrollFinished`	`2`	用于滚动活动的最后一个滚动事件。

另请参阅 QScrollEvent::scrollState。

成员函数文档

QScrollEvent::QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)

创建新的 QScrollEvent contentPos是新内容位置，overshootDistance是新超出距离，scrollState指示此滚动事件是第一个、最后一个还是中间的某个事件。

QPointF QScrollEvent::contentPos() const

返回新的滚动位置。

QPointF QScrollEvent::overshootDistance() const

返回新的超调距离。有关超调的定义，请参阅 QScroller。

另请参阅 QScroller。

QScrollEvent::ScrollState QScrollEvent::scrollState() const

返回当前滚动状态，它是由 ScrollStateFlag 值的组合。如果此滚动事件是滚动活动的第一个（或最后一个）事件，则 ScrollStarted（或 ScrollFinished）将被设置。请注意，如果活动仅包含一个 QScrollEvent，则这两个值可以同时设置。其他所有滚动事件的状态将被设置为 ScrollUpdated。

例如，一个小控件在开始和停止滚动时可能还会撤销选择。