PointerDevice QML Type
QML-Entsprechung für „ QPointingDevice “. Mehr...
| Import Statement: | import QtQuick |
| In C++: | QPointingDevice |
Eigenschaften
- buttonCount : int
- deviceType : enumeration
- maximumPoints : int
- pointerType : enumeration
- uniqueId : pointingDeviceUniqueId
Signale
- grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Ausführliche Beschreibung
„PointerDevice“ ist der QML-Name der Klasse „ QPointingDevice “. Sie verfügt über dieselben Eigenschaften und Aufzählungslisten wie „ QPointingDevice “.
Dokumentation zu den Eigenschaften
buttonCount : int [read-only]
Diese Eigenschaft gibt die maximale Anzahl der Tasten auf dem Gerät an, die erkannt werden können.
deviceType : enumeration
Diese Eigenschaft gibt den Gerätetyp an, der einen „ PointerEvent “ ausgelöst hat.
Gültige Werte sind:
| Konstante | Beschreibung |
|---|---|
PointerDevice.Unknown | Das Gerät kann nicht identifiziert werden. |
PointerDevice.Mouse | Eine Maus. |
PointerDevice.TouchScreen | Ein Touchscreen. |
PointerDevice.TouchPad | Ein Touchpad oder Trackpad. |
PointerDevice.Stylus | Ein Stift auf einem Grafiktablett. |
PointerDevice.Airbrush | Eine Airbrush auf einem Grafiktablett. |
PointerDevice.Puck | Ein Digitalisierer mit Fadenkreuz auf einem Grafiktablett. |
Siehe auch QInputDevice::DeviceType und PointerDeviceHandler::acceptedDevices.
maximumPoints : int [read-only]
Diese Eigenschaft gibt die maximale Anzahl gleichzeitiger Berührungspunkte (Finger) an, die erkannt werden können.
pointerType : enumeration [read-only]
Diese Eigenschaft gibt an, was mit dem „ PointerDevice “ interagiert.
Zwischen dieser Eigenschaft und „ deviceType “ besteht eine gewisse Redundanz. Wird beispielsweise ein Touchscreen verwendet, so ist „ deviceType “ gleich „ TouchScreen “ und „ pointerType “ gleich „ Finger “. Bei einem Grafiktablett ist es jedoch oft möglich, beide Enden des Stifts zu verwenden, und Programme müssen zwischen ihnen unterscheiden. „ PointerDeviceHandler::acceptedDevices “ und „ PointerDeviceHandler::acceptedPointerTypes “ können in Kombination verwendet werden, um die Teilmenge der Ereignisse zu filtern, auf die ein bestimmter Handler reagieren soll.
Gültige Werte sind:
| Konstante | Beschreibung |
|---|---|
PointerDevice.Unknown | Das Gerät kann nicht identifiziert werden. |
PointerDevice.Generic | Eine Maus oder ein Gerät, das eine Maus emuliert. |
PointerDevice.Finger | Ein Finger auf einem Touchscreen. |
PointerDevice.Pen | Ein Stift auf einem Grafiktablett. |
PointerDevice.Eraser | Ein Radierer auf einem Grafiktablett. |
PointerDevice.Cursor | Ein Digitalisierer mit Fadenkreuz auf einem Grafiktablett. |
Siehe auch QPointingDevice::PointerType und PointerDeviceHandler::acceptedPointerTypes.
uniqueId : pointingDeviceUniqueId [read-only]
Diese Eigenschaft kann, sofern verfügbar, eine eindeutige ID für das Gerät liefern. Beispielsweise kann ein Grafiktablett-Stift über eine eindeutige Seriennummer verfügen.
Siehe auch eventPoint und QEventPoint::uniqueId().
Signal-Dokumentation
grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Dieses Signal wird ausgelöst, wenn das Objekt „ grabber “ während der Übertragung von „ event “ eine exklusive oder passive Zugriffssteuerung auf „ point “ erhält oder verliert. „ transition “ gibt an, was aus der Perspektive des Objekts „ grabber “ geschehen ist, bei dem es sich entweder um einen „ Item “ oder einen „Input Handler“ handeln kann.
Gültige Werte für „ transition “ sind:
| Konstante | Beschreibung |
|---|---|
PointerDevice.GrabExclusive | Der „ grabber “ hat die Hauptverantwortung für die Bearbeitung des „ point “ übernommen. |
PointerDevice.UngrabExclusive | Der „ grabber “ hat seine bisherige exklusive Zugriffsberechtigung aufgegeben. |
PointerDevice.CancelGrabExclusive | Die exklusive Zugriffsberechtigung von „ grabber “ wurde übernommen oder aufgehoben. |
PointerDevice.GrabPassive | Die „ grabber “ hat eine passive Kontrolle erlangt, um die „ point “ zu überwachen. |
PointerDevice.UngrabPassive | grabber hat seinen bisherigen passiven Grab aufgegeben. |
PointerDevice.CancelGrabPassive | Der bisherige passive Zugriff wurde abnormal beendet. Hinweis: Ein Grab-Wechsel von einem Objekt zu einem anderen führt zu zwei Signalen: eines, um zu melden, dass ein Objekt seinen Grab verloren hat, und eines, um zu melden, dass es einen anderen Grabber gibt. In anderen Fällen, beim Übergang in einen oder aus einem Nicht-Grab-Zustand, wird nur ein Signal ausgegeben. |
Hinweis: Der entsprechende Handler ist „ onGrabChanged “.
Siehe auch QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber(), QPointerEvent::removePassiveGrabber() und PointerHandler::grabChanged().
© 2026 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.
