PointerHandler QML Type▲

Detailed Description▲

PointerHandler is the base class Input Handler (not registered as a QML type) for events from any kind of pointing device (touch, mouse or graphics tablet).

Property Documentation▲

 

[read-only] active : bool▲

This holds true whenever this Input Handler has taken sole responsibility for handing one or more EventPoints, by successfully taking an exclusive grab of those points. This means that it is keeping its properties up-to-date according to the movements of those Event Points and actively manipulating its target (if any).

[since 5.15] cursorShape : Qt::CursorShape▲

This property holds the cursor shape that will appear whenever the mouse is hovering over the parent item while active is true.

The available cursor shapes are:

  • Qt.ArrowCursor

  • Qt.UpArrowCursor

  • Qt.CrossCursor

  • Qt.WaitCursor

  • Qt.IBeamCursor

  • Qt.SizeVerCursor

  • Qt.SizeHorCursor

  • Qt.SizeBDiagCursor

  • Qt.SizeFDiagCursor

  • Qt.SizeAllCursor

  • Qt.BlankCursor

  • Qt.SplitVCursor

  • Qt.SplitHCursor

  • Qt.PointingHandCursor

  • Qt.ForbiddenCursor

  • Qt.WhatsThisCursor

  • Qt.BusyCursor

  • Qt.OpenHandCursor

  • Qt.ClosedHandCursor

  • Qt.DragCopyCursor

  • Qt.DragMoveCursor

  • Qt.DragLinkCursor

The default value is not set, which allows the cursor of parent item to appear. This property can be reset to the same initial condition by setting it to undefined.

When this property has not been set, or has been set to undefined, if you read the value it will return Qt.ArrowCursor.

This property was introduced in Qt 5.15.

See Also▲

See also Qt::CursorShape, QQuickItem::cursor(), HoverHandler::cursorShape

[since 5.15] dragThreshold : int▲

The distance in pixels that the user must drag an event point in order to have it treated as a drag gesture.

The default value depends on the platform and screen resolution. It can be reset back to the default value by setting it to undefined. The behavior when a drag gesture begins varies in different handlers.

This property was introduced in Qt 5.15.

enabled : bool▲

If a PointerHandler is disabled, it will reject all events and no signals will be emitted.

grabPermissions : flags▲

This property specifies the permissions when this handler's logic decides to take over the exclusive grab, or when it is asked to approve grab takeover or cancellation by another handler.

Constant

Description

PointerHandler.TakeOverForbidden

This handler neither takes from nor gives grab permission to any type of Item or Handler.

PointerHandler.CanTakeOverFromHandlersOfSameType

This handler can take the exclusive grab from another handler of the same class.

PointerHandler.CanTakeOverFromHandlersOfDifferentType

This handler can take the exclusive grab from any kind of handler.

PointerHandler.CanTakeOverFromAnything

This handler can take the exclusive grab from any type of Item or Handler.

PointerHandler.ApprovesTakeOverByHandlersOfSameType

This handler gives permission for another handler of the same class to take the grab.

PointerHandler.ApprovesTakeOverByHandlersOfDifferentType

This handler g