QTouchDevice¶

PyQt5.QtGui.QTouchDevice

Description¶

The QTouchDevice class describes the device from which touch events originate.

Each QTouchEvent contains a QTouchDevice pointer to allow accessing device-specific properties like type and capabilities. It is the responsibility of the platform or generic plug-ins to register the available touch devices via QWindowSystemInterface before generating any touch events. Applications do not need to instantiate this class, they should just access the global instances pointed to by QTouchEvent::device().

Classes¶

Capabilities

Enums¶

CapabilityFlag

TODO

Member	Value	Description
Area	TODO	TODO
MouseEmulation	TODO	TODO
NormalizedPosition	TODO	TODO
Position	TODO	TODO
Pressure	TODO	TODO
RawPositions	TODO	TODO
Velocity	TODO	TODO

DeviceType

This enum represents the type of device that generated a QTouchEvent.

Member	Value	Description
TouchPad	1	In this type of device, the touch surface is separate from the display. There is not a direct relationship between the physical touch location and the on-screen coordinates. Instead, they are calculated relative to the current mouse position, and the user must use the touch-pad to move this reference point. Unlike touch-screens, Qt allows users to only interact with a single QWidget or QGraphicsItem at a time.
TouchScreen	0	In this type of device, the touch surface and display are integrated. This means the surface and display typically have the same size, such that there is a direct relationship between the touch points’ physical positions and the coordinate reported by TouchPoint. As a result, Qt allows the user to interact directly with multiple QWidgets and QGraphicsItems at the same time.

Methods¶

__init__(): Creates a new touch device instance. By default the name is empty, the only capability is Position and type is TouchScreen.

__init__(QTouchDevice): TODO

capabilities() → Capabilities: Returns the touch device capabilities.

See also

setCapabilities().

@staticmethod devices() → List[QTouchDevice]

Returns a list of all registered devices.

Note: The returned list cannot be used to add new devices. To add a simulated touch screen for an autotest, QTest::createTouchDevice() can be used. To add real touch screens to QPA plugins, the private QWindowSystemInterface::registerTouchDevice() function can be used.

maximumTouchPoints() → int: Returns the maximum number of simultaneous touch points (fingers) that can be detected.

See also

setMaximumTouchPoints().

name() → str

Returns the touch device name.

This string may often be empty. It is however useful for systems that have more than one touch input device because there it can be used to differentiate between the devices (i.e. to tell from which device a QTouchEvent originates from).