PointerHandler QML Type
Gestor abstracto de eventos de puntero. Más...
| Import Statement: | import QtQuick |
| Inherited By: | DragHandler, HoverHandler, MultiPointHandler, PinchHandler, PointerDeviceHandler, PointHandler, SinglePointHandler, TapHandler, and WheelHandler |
Propiedades
- active : bool
- cursorShape : Qt::CursorShape
- dragThreshold : int
- enabled : bool
- grabPermissions : flags
- margin : real
- parent : Item
- target : Item
Señales
- canceled(eventPoint point)
- grabChanged(PointerDevice::GrabTransition transition, eventPoint point)
Descripción detallada
PointerHandler es la clase base Input Handler (no registrada como tipo QML) para eventos de cualquier tipo de dispositivo señalador (táctil, ratón o tableta gráfica).
Documentación de Propiedades
active : bool [read-only]
Esto se mantiene true siempre que este Manejador de Entrada haya tomado la responsabilidad exclusiva de manejar uno o más eventPoints, tomando con éxito un agarre exclusivo de esos puntos. Esto significa que está manteniendo sus propiedades actualizadas de acuerdo con los movimientos de esos eventPoints y manipulando activamente su target (si existe).
cursorShape : Qt::CursorShape
Esta propiedad contiene la forma del cursor que aparecerá siempre que el ratón pase por encima del elemento parent mientras active esté true.
Las formas de cursor disponibles son:
- 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.CursorManoCerrada
- Qt.DragCopyCursor
- Qt.DragMoveCursor
- Qt.DragLinkCursor
El valor por defecto no está establecido, lo que permite que aparezca el elemento cursor de parent. Esta propiedad puede restablecerse a la misma condición inicial estableciéndola a undefined.
Nota: Cuando esta propiedad no ha sido establecida, o ha sido establecida a undefined, si se lee el valor devolverá Qt.ArrowCursor.
Véase también Qt::CursorShape, QQuickItem::cursor(), y HoverHandler::cursorShape.
dragThreshold : int
La distancia en píxeles que el usuario debe arrastrar un eventPoint para que se trate como un gesto de arrastre.
El valor por defecto depende de la plataforma y de la resolución de pantalla. Se puede restablecer al valor por defecto estableciéndolo como indefinido. El comportamiento cuando comienza un gesto de arrastre varía en los distintos manejadores.
enabled : bool
Si un PointerHandler está desactivado, rechazará todos los eventos y no se emitirá ninguna señal.
Si un PointerHandler's parent es disabled, el manejador también será efectivamente desactivado, incluso cuando la propiedad enabled permanezca true.
Nota: HoverHandler se comporta de manera diferente: consulte la documentación de su propiedad enabled para obtener más información.
grabPermissions : flags
Esta propiedad especifica los permisos cuando la lógica de este manejador decide hacerse cargo de la toma exclusiva, o cuando se le pide que apruebe la toma o cancelación de la toma por parte de otro manejador.
| Constante | Descripción |
|---|---|
PointerHandler.TakeOverForbidden | Este manejador no toma ni da permiso de toma a ningún tipo de Item o Manejador. |
PointerHandler.CanTakeOverFromHandlersOfSameType | Este manejador puede tomar el agarre exclusivo de otro manejador de la misma clase. |
PointerHandler.CanTakeOverFromHandlersOfDifferentType | Este manejador puede tomar el agarre exclusivo de cualquier tipo de manejador. |
PointerHandler.CanTakeOverFromItems | Este manejador puede tomar el agarre exclusivo de cualquier tipo de Item. |
PointerHandler.CanTakeOverFromAnything | Este manejador puede tomar la exclusiva de cualquier tipo de Item o Manejador. |
PointerHandler.ApprovesTakeOverByHandlersOfSameType | Este manipulador da permiso a otro manipulador de la misma clase para tomar la captura. |
PointerHandler.ApprovesTakeOverByHandlersOfDifferentType | Este manipulador da permiso a cualquier tipo de manipulador para tomar la captura. |
PointerHandler.ApprovesTakeOverByItems | Este manejador da permiso para que cualquier tipo de Item tome el agarre. |
PointerHandler.ApprovesCancellation | Este manejador permitirá que su agarre sea nulo. |
PointerHandler.ApprovesTakeOverByAnything | Este manipulador permite que cualquier tipo de objeto o manipulador tome la captura. |
El valor predeterminado es PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything que permite la mayoría de los escenarios de toma, pero evita, por ejemplo, dos PinchHandlers luchando por los mismos puntos de contacto.
margin : real
El margen más allá de los límites del elemento parent dentro del cual un eventPoint puede activar este manejador. Por ejemplo, en un PinchHandler en el que el target es también el parent, es útil establecerlo a una distancia de al menos la mitad de la anchura del dedo de un usuario típico, de modo que si el parent se ha reducido a un tamaño muy pequeño, el gesto de pellizcar siga siendo posible. O, si se coloca un botón basado en TapHandler cerca del borde de la pantalla, puede utilizarse para cumplir la Ley de Fitts: reaccionar a los clics del ratón en el borde de la pantalla aunque el botón esté visualmente separado del borde por unos pocos píxeles.
El valor por defecto es 0.
parent : Item
El Item que es el ámbito del manejador; el Item en el que fue declarado. El manejador manejará eventos en nombre de este Item, lo que significa que un evento de puntero es relevante si al menos uno de sus eventPoints ocurre dentro del interior del Item. Inicialmente target() es el mismo, pero puede ser reasignado.
Véase también target y QObject::parent().
target : Item
Elemento que manipulará este controlador.
Por defecto, es el mismo que parent, el Item dentro del cual se declara el manejador. Sin embargo, a veces puede ser útil establecer el objetivo a un Item diferente, para manejar eventos dentro de un item pero manipular otro; o a null, para desactivar el comportamiento por defecto y hacer otra cosa en su lugar.
Documentación sobre señales
canceled(eventPoint point)
Si este manejador ya ha agarrado el point dado, esta señal es emitida cuando el agarre es robado por un Manejador de Punteros o Item diferente.
Nota: El manejador correspondiente es onCanceled.
grabChanged(PointerDevice::GrabTransition transition, eventPoint point)
Esta señal se emite cuando la cuchara ha cambiado de alguna manera que es relevante para este controlador.
El transition (verbo) dice lo que ha pasado. El point (objeto) es el punto que fue agarrado o no agarrado.
Los valores válidos para transition son:
| Constante | Descripción |
|---|---|
PointerDevice.GrabExclusive | Este gestor ha asumido la responsabilidad principal de gestionar el point. |
PointerDevice.UngrabExclusive | Este manipulador ha renunciado a su captura exclusiva anterior. |
PointerDevice.CancelGrabExclusive | La captura exclusiva de este gestor ha sido asumida o cancelada. |
PointerDevice.GrabPassive | Este manipulador ha adquirido una captura pasiva, para supervisar la point. |
PointerDevice.UngrabPassive | Este manipulador ha renunciado a su captura pasiva anterior. |
PointerDevice.CancelGrabPassive | La captura pasiva anterior de este manipulador ha finalizado de forma anormal. |
Nota: El controlador correspondiente es onGrabChanged.
© 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.
