PointerDevice QML Type
QML-Äquivalent 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 hat die gleichen Eigenschaften und Enums wie QPointingDevice.
Eigenschaft Dokumentation
buttonCount : int |
Diese Eigenschaft gibt die maximale Anzahl von Gerätetasten an, die erkannt werden können.
deviceType : enumeration |
Diese Eigenschaft gibt den Gerätetyp an, der ein PointerEvent erzeugt 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 Eingabestift auf einem Grafiktablett. |
PointerDevice.Airbrush | Ein Airbrush auf einem Grafiktablett. |
PointerDevice.Puck | Ein Digitalisiergerät mit Fadenkreuz auf einem Grafiktablett. |
Siehe auch QInputDevice::DeviceType und PointerDeviceHandler::acceptedDevices.
maximumPoints : int |
Diese Eigenschaft gibt die maximale Anzahl von gleichzeitigen Berührungspunkten (Fingern) an, die erkannt werden können.
pointerType : enumeration |
Diese Eigenschaft gibt an, was mit der PointerDevice interagiert.
Es besteht eine gewisse Redundanz zwischen dieser Eigenschaft und deviceType. Wenn zum Beispiel ein Touchscreen verwendet wird, dann ist deviceType gleich TouchScreen und pointerType gleich Finger. Auf einem Grafiktablett ist es jedoch oft möglich, dass beide Enden des Stifts verwendet werden, 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 Eingabestift auf einem Grafiktablett. |
PointerDevice.Eraser | Ein Radiergummi auf einem Grafiktablett. |
PointerDevice.Cursor | Ein Digitalisiergerät mit Fadenkreuz auf einem Grafiktablett. |
Siehe auch QPointingDevice::PointerType und PointerDeviceHandler::acceptedPointerTypes.
uniqueId : pointingDeviceUniqueId |
Diese Eigenschaft kann, falls vorhanden, eine eindeutige ID für das Gerät liefern. Beispielsweise kann ein Grafiktablett-Stiftgerät eine eindeutige Seriennummer haben.
Siehe auch eventPoint und QEventPoint::uniqueId().
Signal Dokumentation
grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point) |
Dieses Signal wird ausgegeben, wenn das Objekt grabber während der Übergabe von event einen exklusiven oder passiven Zugriff auf point erhält oder verliert. transition teilt mit, was aus der Sicht des Objekts grabber passiert ist, das entweder ein Item oder ein Input Handler sein 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 seinen bisherigen exklusiven Zugriff aufgegeben. |
PointerDevice.CancelGrabExclusive | Der exklusive Zugriff von grabber wurde übernommen oder aufgehoben. |
PointerDevice.GrabPassive | Der grabber hat einen passiven Zugriff erworben, um den point zu überwachen. |
PointerDevice.UngrabPassive | Die grabber hat ihren bisherigen passiven Zugriff aufgegeben. |
PointerDevice.CancelGrabPassive | Der vorherige passive Greifer wurde abnormal beendet. |
Hinweis: Ein Übergang von einem Objekt zu einem anderen führt zu zwei Signalen, um mitzuteilen, dass ein Objekt seinen Greifer verloren hat, und um mitzuteilen, dass es einen anderen Greifer gibt. In anderen Fällen, wenn der Übergang zu oder von einem nicht-grabbenden Zustand erfolgt, wird nur ein Signal ausgesendet.
Hinweis: Der entsprechende Handler ist onGrabChanged.
Siehe auch QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber(), QPointerEvent::removePassiveGrabber(), und PointerHandler::grabChanged().
© 2025 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.
