QEventPoint 类

QEventPoint 类提供的信息有关点在 QPointerEvent . 更多...

头：	#include <QEventPoint>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui
Since:	Qt 6.0

• 所有成员列表，包括继承成员
• 弃用成员

公共类型

enum	State { Unknown, Stationary, Pressed, Updated, Released }
flags	状态

特性

accepted : bool device : const QPointingDevice* ellipseDiameters : const QSizeF globalGrabPosition : const QPointF globalLastPosition : const QPointF globalPosition : const QPointF globalPressPosition : const QPointF grabPosition : const QPointF id : const int lastPosition : const QPointF lastTimestamp : const ulong 位置 : const QPointF pressPosition : const QPointF

pressTimestamp : const ulong pressure : const qreal rotation : const qreal sceneGrabPosition : const QPointF sceneLastPosition : const QPointF scenePosition : const QPointF scenePressPosition : const QPointF state : const State timeHeld : const qreal timestamp : const ulong uniqueId : const QPointingDeviceUniqueId velocity : const QVector2D

公共函数

	QEventPoint (int pointId , QEventPoint::State state , const QPointF & scenePosition , const QPointF & globalPosition )
	QEventPoint (const QEventPoint & other )
	QEventPoint (QEventPoint && other )
	~QEventPoint ()
const QPointingDevice *	device () const
QSizeF	ellipseDiameters () const
QPointF	globalGrabPosition () const
QPointF	globalLastPosition () const
QPointF	globalPosition () const
QPointF	globalPressPosition () const
QPointF	grabPosition () const
int	id () const
bool	isAccepted () const
QPointF	lastPosition () const
ulong	lastTimestamp () const
QPointF	normalizedPosition () const
QPointF	位置 () const
QPointF	pressPosition () const
ulong	pressTimestamp () const
qreal	pressure () const
qreal	rotation () const
QPointF	sceneGrabPosition () const
QPointF	sceneLastPosition () const
QPointF	scenePosition () const
QPointF	scenePressPosition () const
void	setAccepted (bool accepted = true)
QEventPoint::State	state () const
qreal	timeHeld () const
ulong	timestamp () const
QPointingDeviceUniqueId	uniqueId () const
QVector2D	velocity () const
bool	operator!= (const QEventPoint & other ) const
QEventPoint &	operator= (QEventPoint && other )
QEventPoint &	operator= (const QEventPoint & other )
bool	operator== (const QEventPoint & other ) const

详细描述

成员类型文档编制

enum QEventPoint:: State
flags QEventPoint:: 状态

指定此事件点的状态。

常量	值	描述
QEventPoint::Unknown	Qt::TouchPointUnknownState	未知状态。
QEventPoint::Stationary	Qt::TouchPointStationary	事件点未移动。
QEventPoint::Pressed	Qt::TouchPointPressed	触摸点 (或按钮) 被按下。
QEventPoint::Updated	Qt::TouchPointMoved	事件点被更新。
QEventPoint::Released	Qt::TouchPointReleased	触摸点 (或按钮) 被释放。

States 类型是 typedef 对于 QFlags <State>。它存储 State 值的 OR (或) 组合。

特性文档编制

accepted : bool

此特性保持事件点的接受状态。

In widget-based applications, this property is not used, as it's only meaningful for a widget to accept or reject a complete QInputEvent .

In Qt Quick however, it's normal for an Item or Event Handler to accept only the individual points in a QTouchEvent that are actually participating in a gesture, while other points can be delivered to other items or handlers. For the sake of consistency, that applies to any QPointerEvent ; and delivery is done only when all points in a QPointerEvent have been accepted.

访问函数：

bool	isAccepted () const
void	setAccepted (bool accepted = true)

另请参阅 QEvent::accepted .

[read-only] device : const QPointingDevice *

This property holds the pointing device from which this event point originates.

访问函数：

const QPointingDevice *

device () const

[read-only] ellipseDiameters : const QSizeF

This property holds the width and height of the bounding ellipse of the touch point.

The return value is in logical pixels. Most touchscreens do not detect the shape of the contact point, and no mice or tablet devices can detect it, so a null size is the most common value. On some touchscreens the diameters may be nonzero and always equal (the ellipse is approximated as a circle).

访问函数：

QSizeF

ellipseDiameters () const

[read-only] globalGrabPosition : const QPointF

This property holds the global position at which this point was grabbed.

The global position is relative to the screen or virtual desktop.

访问函数：

QPointF

globalGrabPosition () const

另请参阅 globalPosition , grabPosition ，和 sceneGrabPosition .

[read-only] globalLastPosition : const QPointF

This property holds the global position of this point from the previous press or move event.

The global position is relative to the screen or virtual desktop.

访问函数：

QPointF

globalLastPosition () const

另请参阅 globalPosition , lastPosition ，和 sceneLastPosition .

[read-only] globalPosition : const QPointF

This property holds the global position of this point.

The global position is relative to the screen or virtual desktop.

访问函数：

QPointF

globalPosition () const

另请参阅 globalPressPosition , 位置 ，和 scenePosition .

[read-only] globalPressPosition : const QPointF

This property holds the global position at which this point was pressed.

The global position is relative to the screen or virtual desktop.

访问函数：

QPointF

globalPressPosition () const

另请参阅 globalPosition , pressPosition ，和 scenePressPosition .

[read-only] grabPosition : const QPointF

This property holds the position at which this point was grabbed.

The position is relative to the widget or item that received the event.

访问函数：

QPointF

grabPosition () const

另请参阅 位置 .

[read-only] id : const int

此特性保持此事件点的 ID 编号。

注意： Do not assume that ID numbers start at zero or that they are sequential. Such an assumption is often false due to the way the underlying drivers work.

访问函数：

int	id () const

[read-only] lastPosition : const QPointF

This property holds the position of this point from the previous press or move event.

The position is relative to the widget or item that received the event.

访问函数：

QPointF

lastPosition () const

另请参阅 位置 and pressPosition .

[read-only] lastTimestamp : const ulong

This property holds the time from the previous QPointerEvent that contained this point.

访问函数：

ulong

lastTimestamp () const

另请参阅 globalLastPosition .

[read-only] 位置 : const QPointF

此特性保持此点的位置。

The position is relative to the widget or item that received the event.

访问函数：

QPointF

位置 () const

[read-only] pressPosition : const QPointF

This property holds the position at which this point was pressed.

The position is relative to the widget or item that received the event.

访问函数：

QPointF

pressPosition () const

另请参阅 位置 .

[read-only] pressTimestamp : const ulong

This property holds the most recent time at which this point was pressed.

访问函数：

ulong

pressTimestamp () const

另请参阅 timestamp .

[read-only] pressure : const qreal

此特性保持此点的压力。

返回值在范围 0.0 to 1.0 .

访问函数：

qreal

pressure () const

[read-only] rotation : const qreal

This property holds the angular orientation of this point.

The return value is in degrees, where zero (the default) indicates the finger, token or stylus is pointing upwards, a negative angle means it's rotated to the left, and a positive angle means it's rotated to the right. Most touchscreens do not detect rotation, so zero is the most common value.

访问函数：

qreal

rotation () const

[read-only] sceneGrabPosition : const QPointF

This property holds the scene position at which this point was grabbed.

The scene position is the position relative to QQuickWindow if handled in QQuickItem::event (), in QGraphicsScene coordinates if handled by an override of QGraphicsItem::touchEvent(), or the window position in widget applications.

访问函数：

QPointF

sceneGrabPosition () const

另请参阅 scenePosition , grabPosition ，和 globalGrabPosition .

[read-only] sceneLastPosition : const QPointF

This property holds the scene position of this point from the previous press or move event.

The scene position is the position relative to QQuickWindow if handled in QQuickItem::event (), in QGraphicsScene coordinates if handled by an override of QGraphicsItem::touchEvent(), or the window position in widget applications.

访问函数：

QPointF

sceneLastPosition () const

另请参阅 scenePosition and scenePressPosition .

[read-only] scenePosition : const QPointF

This property holds the scene position of this point.

The scene position is the position relative to QQuickWindow if handled in QQuickItem::event (), in QGraphicsScene coordinates if handled by an override of QGraphicsItem::touchEvent(), or the window position in widget applications.

访问函数：

QPointF

scenePosition () const

另请参阅 scenePressPosition , 位置 ，和 globalPosition .

[read-only] scenePressPosition : const QPointF

This property holds the scene position at which this point was pressed.

The scene position is the position relative to QQuickWindow if handled in QQuickItem::event (), in QGraphicsScene coordinates if handled by an override of QGraphicsItem::touchEvent(), or the window position in widget applications.

访问函数：

QPointF

scenePressPosition () const

另请参阅 scenePosition , pressPosition ，和 globalPressPosition .

[read-only] state : const State

此特性保持事件点的当前状态。

访问函数：

QEventPoint::State

state () const

[read-only] timeHeld : const qreal

This property holds the duration, in seconds, since this point was pressed and not released.

访问函数：

qreal

timeHeld () const

另请参阅 pressTimestamp and timestamp .

[read-only] timestamp : const ulong

This property holds the most recent time at which this point was included in a QPointerEvent .

访问函数：

ulong

timestamp () const

另请参阅 QPointerEvent::timestamp ().

[read-only] uniqueId : const QPointingDeviceUniqueId

This property holds the unique ID of this point or token, if any.

It is often invalid (see isValid ()), because touchscreens cannot uniquely identify fingers.

When it comes from a QTabletEvent , it identifies the serial number of the stylus in use.

It may identify a specific token (fiducial object) when the TUIO driver is in use with a touchscreen that supports them.

访问函数：

QPointingDeviceUniqueId

uniqueId () const

[read-only] velocity : const QVector2D

This property holds a velocity vector, in units of pixels per second, in the coordinate. system of the screen or desktop.

注意： If the device's capabilities include QInputDevice::Velocity , it means velocity comes from the operating system (perhaps the touch hardware or driver provides it). But usually the Velocity capability is not set, indicating that the velocity is calculated by Qt, using a simple Kalman filter to provide a smoothed average velocity rather than an instantaneous value. Effectively it tells how fast and in what direction the user has been dragging this point over the last few events, with the most recent event having the strongest influence.

访问函数：

QVector2D

velocity () const

另请参阅 QInputDevice::capabilities () 和 QInputEvent::device ().

成员函数文档编制

QEventPoint:: QEventPoint ( int pointId , QEventPoint::State state , const QPointF & scenePosition , const QPointF & globalPosition )

构造事件点采用给定 pointId , state , scenePosition and globalPosition .

[noexcept] QEventPoint:: QEventPoint (const QEventPoint & other )

Constructs an event point by making a shallow copy of other .

[noexcept] QEventPoint:: QEventPoint ( QEventPoint && other )

构造事件点通过移动 other .

[noexcept] QEventPoint:: ~QEventPoint ()

销毁事件点。

QPointF QEventPoint:: normalizedPosition () const

返回此点的规范化位置。

The coordinates are calculated by transforming globalPosition () into the space of QInputDevice::availableVirtualGeometry ()，即 (0, 0) is the top-left corner and (1, 1) is the bottom-right corner.

另请参阅 globalPosition .

[noexcept] bool QEventPoint:: operator!= (const QEventPoint & other ) const

返回 true 若此事件点不等于 other ，否则返回 false .

[noexcept] QEventPoint &QEventPoint:: operator= ( QEventPoint && other )

移动赋值 other 到此事件点实例。

[noexcept] QEventPoint &QEventPoint:: operator= (const QEventPoint & other )

赋值 other to this event point and returns a reference to this event point.

[noexcept] bool QEventPoint:: operator== (const QEventPoint & other ) const

返回 true 若此事件点等于 other ，否则返回 false .

内容

1. 公共类型

2. 特性

3. 公共函数

4. 详细描述