class QEventPoint

The QEventPoint class provides information about a point in a QPointerEvent . More…

Synopsis

Properties

• acceptedᅟ - The accepted state of the event point

• deviceᅟ - The pointing device from which this event point originates

• ellipseDiametersᅟ - The width and height of the bounding ellipse of the touch point

• globalGrabPositionᅟ - The global position at which this point was grabbed

• globalLastPositionᅟ - The global position of this point from the previous press or move event

• globalPositionᅟ - The global position of this point

• globalPressPositionᅟ - The global position at which this point was pressed

• grabPositionᅟ - The position at which this point was grabbed

• idᅟ - The ID number of this event point

• lastPositionᅟ - The position of this point from the previous press or move event

• lastTimestampᅟ - The time from the previous QPointerEvent that contained this point

• positionᅟ - The position of this point

• pressPositionᅟ - The position at which this point was pressed

• pressTimestampᅟ - The most recent time at which this point was pressed

• pressureᅟ - The pressure of this point

• rotationᅟ - The angular orientation of this point

• sceneGrabPositionᅟ - The scene position at which this point was grabbed

• sceneLastPositionᅟ - The scene position of this point from the previous press or move event

• scenePositionᅟ - The scene position of this point

• scenePressPositionᅟ - The scene position at which this point was pressed

• stateᅟ - The current state of the event point

• timeHeldᅟ - The duration, in seconds, since this point was pressed and not released

• timestampᅟ - The most recent time at which this point was included in a QPointerEvent

• uniqueIdᅟ - The unique ID of this point or token, if any

• velocityᅟ - Velocity vector, in units of pixels per second, in the coordinate. system of the screen or desktop

Methods

• def __init__()

• def device()

• def ellipseDiameters()

• def globalGrabPosition()

• def globalLastPosition()

• def globalPosition()

• def globalPressPosition()

• def grabPosition()

• def id()

• def isAccepted()

• def lastNormalizedPos()

• def lastPos()

• def lastPosition()

• def lastScenePos()

• def lastScreenPos()

• def lastTimestamp()

• def normalizedPos()

• def normalizedPosition()

• def __ne__()

• def __eq__()

• def pos()

• def position()

• def pressPosition()

• def pressTimestamp()

• def pressure()

• def rotation()

• def sceneGrabPosition()

• def sceneLastPosition()

• def scenePos()

• def scenePosition()

• def scenePressPosition()

• def screenPos()

• def setAccepted()

• def startNormalizedPos()

• def startPos()

• def startScenePos()

• def startScreenPos()

• def state()

• def swap()

• def timeHeld()

• def timestamp()

• def uniqueId()

• def velocity()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

class State

Specifies the state of this event point.

Constant	Description
QEventPoint.Unknown	Unknown state.
QEventPoint.Stationary	The event point did not move.
QEventPoint.Pressed	The touch point or button is pressed.
QEventPoint.Updated	The event point was updated.
QEventPoint.Released	The touch point or button was released.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property acceptedᅟ: bool

This property holds the accepted state of the event point..

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.

See also

accepted

Access functions:

• isAccepted()

• setAccepted()

property deviceᅟ: QPointingDevice

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

Access functions:

• device()

property ellipseDiametersᅟ: 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).

Access functions:

• ellipseDiameters()

property globalGrabPositionᅟ: QPointF

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

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

See also

globalPosition grabPosition sceneGrabPosition

Access functions:

• globalGrabPosition()

property globalLastPositionᅟ: 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.

See also

globalPosition lastPosition sceneLastPosition

Access functions:

• globalLastPosition()

property globalPositionᅟ: QPointF

This property holds the global position of this point..

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

See also

globalPressPosition position scenePosition

Access functions:

• globalPosition()

property globalPressPositionᅟ: QPointF

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

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

See also

globalPosition pressPosition scenePressPosition

Access functions:

• globalPressPosition()

property grabPositionᅟ: 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.

See also

position

Access functions:

• grabPosition()

property idᅟ: int

This property holds the ID number of this event point..

Note

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.

Access functions:

• id()

property lastPositionᅟ: 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.

See also

position pressPosition

Access functions:

• lastPosition()

property lastTimestampᅟ: int

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

See also

globalLastPosition

Access functions:

• lastTimestamp()

property positionᅟ: QPointF

This property holds the position of this point..

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

Access functions:

• position()

property pressPositionᅟ: 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.

See also

position

Access functions:

• pressPosition()

property pressTimestampᅟ: int

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

See also

timestamp

Access functions:

• pressTimestamp()

property pressureᅟ: float

This property holds the pressure of this point..

The return value is in the range 0.0 to 1.0.

Access functions:

• pressure()

property rotationᅟ: float

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.

Access functions:

• rotation()

property sceneGrabPositionᅟ: 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.

See also

scenePosition grabPosition globalGrabPosition

Access functions:

• sceneGrabPosition()

property sceneLastPositionᅟ: 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.

See also

scenePosition scenePressPosition

Access functions:

• sceneLastPosition()

property scenePositionᅟ: 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.

See also

scenePressPosition position globalPosition

Access functions:

• scenePosition()

property scenePressPositionᅟ: 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.

See also

scenePosition pressPosition globalPressPosition

Access functions:

• scenePressPosition()

property stateᅟ: QEventPoint.State

This property holds the current state of the event point..

Access functions:

• state()

property timeHeldᅟ: float

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

See also

pressTimestamp timestamp

Access functions:

• timeHeld()

property timestampᅟ: int

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

See also

timestamp()

Access functions:

• timestamp()

property uniqueIdᅟ: 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.

Access functions:

• uniqueId()

property velocityᅟ: QVector2D

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

Note

If the device’s capabilities include 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.

See also

capabilities() device()

Access functions:

• velocity()

__init__([id=-1[, device=None]])

Parameters:

• id – int

• device – QPointingDevice

__init__(other)

Parameters:

other – QEventPoint

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

__init__(pointId, state, scenePosition, globalPosition)

Parameters:

• pointId – int

• state – State

• scenePosition – QPointF

• globalPosition – QPointF

Constructs an event point with the given pointId, state, scenePosition and globalPosition.

device()

Return type:

QPointingDevice

Getter of property deviceᅟ .

ellipseDiameters()

Return type:

QSizeF

Getter of property ellipseDiametersᅟ .

globalGrabPosition()

Return type:

QPointF

Getter of property globalGrabPositionᅟ .

globalLastPosition()

Return type:

QPointF

Getter of property globalLastPositionᅟ .

globalPosition()

Return type:

QPointF

Getter of property globalPositionᅟ .

globalPressPosition()

Return type:

QPointF

Getter of property globalPressPositionᅟ .

grabPosition()

Return type:

QPointF

Getter of property grabPositionᅟ .

id()

Return type:

int

Getter of property idᅟ .

isAccepted()

Return type:

bool

Getter of property acceptedᅟ .

lastNormalizedPos()

Return type:

QPointF

Note

This function is deprecated.

Use globalLastPosition() instead.

Returns the normalized position of this point from the previous press or move event.

The coordinates are normalized to availableVirtualGeometry() , i.e. (0, 0) is the top-left corner and (1, 1) is the bottom-right corner.

See also

normalizedPosition() globalPressPosition()

lastPos()

Return type:

QPointF

Note

This function is deprecated.

lastPosition()

Return type:

QPointF

Getter of property lastPositionᅟ .

lastScenePos()

Return type:

QPointF

Note

This function is deprecated.

lastScreenPos()

Return type:

QPointF

Note

This function is deprecated.

lastTimestamp()

Return type:

int

Getter of property lastTimestampᅟ .

normalizedPos()

Return type:

QPointF

Note

This function is deprecated.

Use normalizedPosition() instead.

normalizedPosition()

Return type:

QPointF

Returns the normalized position of this point.

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

See also

globalPosition

__ne__(other)

Parameters:

other – QEventPoint

Return type:

bool

Returns true if this event point is not equal to other, otherwise return false.

__eq__(other)

Parameters:

other – QEventPoint

Return type:

bool

Returns true if this event point is equal to other, otherwise return false.

pos()

Return type:

QPointF

Note

This function is deprecated.

Use position() instead.

Returns the position of this point, relative to the widget or item that received the event.

position()

Return type:

QPointF

Getter of property positionᅟ .

pressPosition()

Return type:

QPointF

Getter of property pressPositionᅟ .

pressTimestamp()

Return type:

int

Getter of property pressTimestampᅟ .

pressure()

Return type:

float

Getter of property pressureᅟ .

rotation()

Return type:

float

Getter of property rotationᅟ .

sceneGrabPosition()

Return type:

QPointF

Getter of property sceneGrabPositionᅟ .

sceneLastPosition()

Return type:

QPointF

Getter of property sceneLastPositionᅟ .

scenePos()

Return type:

QPointF

Note

This function is deprecated.

scenePosition()

Return type:

QPointF

Getter of property scenePositionᅟ .

scenePressPosition()

Return type:

QPointF

Getter of property scenePressPositionᅟ .

screenPos()

Return type:

QPointF

Note

This function is deprecated.

setAccepted([accepted=true])

Parameters:

accepted – bool

See also

isAccepted()

Setter of property acceptedᅟ .

startNormalizedPos()

Return type:

QPointF

Note

This function is deprecated.

Use globalPressPosition() instead.

Returns the normalized press position of this point.

startPos()

Return type:

QPointF

Note

This function is deprecated.

startScenePos()

Return type:

QPointF

Note

This function is deprecated.

startScreenPos()

Return type:

QPointF

Note

This function is deprecated.

state()

Return type:

State

Getter of property stateᅟ .

swap(other)

Parameters:

other – QEventPoint

timeHeld()

Return type:

float

Getter of property timeHeldᅟ .

timestamp()

Return type:

int

Getter of property timestampᅟ .

uniqueId()

Return type:

QPointingDeviceUniqueId

Getter of property uniqueIdᅟ .

velocity()

Return type:

QVector2D

Getter of property velocityᅟ .