PointerDevice QML Type

Provides information about a pointing device. More...

Import Statement: import QtQuick 2.15


Detailed Description

A pointing device can be a mouse, a touchscreen, or a stylus on a graphics tablet.

See also PointerEvent and PointerHandler.

Property Documentation

[read-only] capabilities : enumeration

This property holds a bitwise combination of the capabilities of the pointing device. It tells you under which conditions events are sent, and which properties of PointerEvent are expected to be valid.

Valid values are:

CapabilityFlag.Positionthe position and scenePosition properties
CapabilityFlag.Areathe ellipseDiameters property
CapabilityFlag.Pressurethe pressure property
CapabilityFlag.Velocitythe velocity property
CapabilityFlag.Scrolla Mouse has a wheel, or the operating system recognizes scroll gestures on a TouchPad
CapabilityFlag.Hoverevents are sent even when no button is pressed, or the finger or stylus is not in contact with the surface
CapabilityFlag.Rotationthe rotation property
CapabilityFlag.XTilthorizontal angle between a stylus and the axis perpendicular to the surface
CapabilityFlag.YTiltvertical angle between a stylus and the axis perpendicular to the surface

See also QTouchDevice::capabilities.

[read-only] pointerType : enumeration

This property holds a value indicating what is interacting with the device. Think of the device as having a planar 2D surface, and the value of this property as identifying what interacts with the device.

There is some redundancy between this property and PointerDevice::type. If a tocuchscreen is used, then the device is TouchScreen and pointerType is Finger (always).

Valid values are:

PointerDevice.GenericPointera mouse or something acting like a mouse (the core pointer on X11)
PointerDevice.Fingerthe user's finger
PointerDevice.Penthe drawing end of a stylus
PointerDevice.Eraserthe other end of the stylus (if it has a virtual eraser on the other end)
PointerDevice.Cursora cursor in the pre-computer sense of the word
PointerDevice.AllPointerTypesany of the above (used as a default value in constructors)

[read-only] type : enumeration

This property holds the type of the pointing device.

Valid values are:

DeviceType.UnknownDevicethe device cannot be identified
DeviceType.Mousea mouse
DeviceType.TouchScreena touchscreen providing absolute coordinates
DeviceType.TouchPada trackpad or touchpad providing relative coordinates
DeviceType.Stylusa pen-like device
DeviceType.Airbrusha stylus with a thumbwheel to adjust tangentialPressure
DeviceType.Pucka device that is similar to a flat mouse with a transparent circle with cross-hairs (same as Puck)
DeviceType.AllDevicesany of the above; used as a default value for construction

See also QTouchDevice::DeviceType.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.