PointerDevice QML Type

Provides information about a pointing device. More...

Import Statement: import QtQuick 2.15

Properties

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:

ConstantDescription
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:

ConstantDescription
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:

ConstantDescription
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.