PointerDevice QML Type

Provides information about a pointing device. More...

Import Statement:

import QtQuick 2.15

• List of all members, including inherited members

Properties

• capabilities : enumeration
• pointerType : enumeration
• type : enumeration

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:

Constant	Description
CapabilityFlag.Position	the position and scenePosition properties
CapabilityFlag.Area	the ellipseDiameters property
CapabilityFlag.Pressure	the pressure property
CapabilityFlag.Velocity	the velocity property
CapabilityFlag.Scroll	a Mouse has a wheel, or the operating system recognizes scroll gestures on a TouchPad
CapabilityFlag.Hover	events are sent even when no button is pressed, or the finger or stylus is not in contact with the surface
CapabilityFlag.Rotation	the rotation property
CapabilityFlag.XTilt	horizontal angle between a stylus and the axis perpendicular to the surface
CapabilityFlag.YTilt	vertical 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:

Constant	Description
PointerDevice.GenericPointer	a mouse or something acting like a mouse (the core pointer on X11)
PointerDevice.Finger	the user's finger
PointerDevice.Pen	the drawing end of a stylus
PointerDevice.Eraser	the other end of the stylus (if it has a virtual eraser on the other end)
PointerDevice.Cursor	a cursor in the pre-computer sense of the word
PointerDevice.AllPointerTypes	any 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:

Constant	Description
DeviceType.UnknownDevice	the device cannot be identified
DeviceType.Mouse	a mouse
DeviceType.TouchScreen	a touchscreen providing absolute coordinates
DeviceType.TouchPad	a trackpad or touchpad providing relative coordinates
DeviceType.Stylus	a pen-like device
DeviceType.Airbrush	a stylus with a thumbwheel to adjust tangentialPressure
DeviceType.Puck	a device that is similar to a flat mouse with a transparent circle with cross-hairs (same as Puck)
DeviceType.AllDevices	any of the above; used as a default value for construction

See also QTouchDevice::DeviceType.