En esta página

PointerHandler QML Type (Uncreatable)

Manejador abstracto para eventos de puntero. Más...

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Señales

  • canceled(eventPoint point)
  • grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

Descripción detallada

PointerHandler es la clase base del gestor de entradas (no registrada como tipo QML) para eventos procedentes 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 cumple true siempre que este gestor de entrada haya asumido la responsabilidad exclusiva de gestionar uno o varios eventPoints, al haber conseguido la captura exclusiva de dichos puntos. Esto significa que mantiene sus propiedades actualizadas en función de los movimientos de esos eventPoints y que manipula activamente sus target (si los hay).

cursorShape : Qt::CursorShape

Esta propiedad define la forma del cursor que aparecerá cada vez que el ratón se sitúe sobre el elemento « parent » mientras « active » tenga el valor « true ».

Las formas de cursor disponibles son:

  • Qt.ArrowCursor
  • Qt.UpArrowCursor
  • Qt.CrossCursor
  • Qt.WaitCursor
  • Qt.IBeamCursor
  • Qt.CursorVerticalDeTamaño
  • Qt.CursorDeTamañoHorizontal
  • Qt.SizeBDiagCursor
  • Qt.SizeFDiagCursor
  • Qt.SizeAllCursor
  • Qt.Cursor en blanco
  • Qt.CursorDivisiónVertical
  • Qt.CursorDivisiónHorizontal
  • Qt.CursorManoSeñalando
  • Qt.CursorProhibido
  • Qt.CursorInformativo
  • Qt.CursorOcupado
  • Qt.Cursor de mano abierta
  • Qt.Cursor de mano cerrada
  • Qt.CursorDeArrastrarYCopiar
  • Qt.CursorArrastrarMover
  • Qt.DragLinkCursor

El valor por defecto no está establecido, lo que permite que aparezca el « cursor » del elemento « parent ». Esta propiedad se puede restablecer a su estado inicial asignándole el valor «undefined».

Nota: Cuando esta propiedad no se ha establecido, o se ha establecido en ` undefined`, si se lee su 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 considere un gesto de arrastre.

El valor por defecto depende de la plataforma y de la resolución de la pantalla. Se puede restablecer al valor por defecto estableciéndolo en «undefined». El comportamiento al iniciar un gesto de arrastre varía según los distintos controladores.

enabled : bool

Si se desactiva un « PointerHandler », rechazará todos los eventos y no se emitirá ninguna señal.

Si la propiedad « parent » de un « PointerHandler » tiene el valor « disabled », el controlador también quedará desactivado de forma efectiva, incluso cuando la propiedad « enabled » siga teniendo el valor « true ».

Nota: HoverHandler se comporta de forma diferente: consulta la documentación de su propiedad enabled para obtener más información.

grabPermissions : flags

Esta propiedad especifica los permisos para los casos en los que la lógica de este controlador decide hacerse cargo del control exclusivo, o cuando otro controlador le solicita que apruebe la toma de control o la cancelación de dicho control.

ConstanteDescripción
PointerHandler.TakeOverForbiddenEste controlador no toma ni concede permiso de control a ningún tipo de elemento o controlador.
PointerHandler.CanTakeOverFromHandlersOfSameTypeEste controlador puede tomar el control exclusivo de otro controlador de la misma clase.
PointerHandler.CanTakeOverFromHandlersOfDifferentTypeEste controlador puede tomar el control exclusivo de cualquier tipo de controlador.
PointerHandler.CanTakeOverFromItemsEste controlador puede tomar el control exclusivo de cualquier tipo de elemento.
PointerHandler.CanTakeOverFromAnythingEste controlador puede tomar el control exclusivo de cualquier tipo de elemento o controlador.
PointerHandler.ApprovesTakeOverByHandlersOfSameTypeEste controlador concede permiso a otro controlador de la misma clase para que adquiera el control.
PointerHandler.ApprovesTakeOverByHandlersOfDifferentTypeEste controlador concede permiso a cualquier tipo de controlador para que adquiera el control.
PointerHandler.ApprovesTakeOverByItemsEste controlador permite que cualquier tipo de elemento adquiera el control.
PointerHandler.ApprovesCancellationEste controlador permitirá que su control se establezca en nulo.
PointerHandler.ApprovesTakeOverByAnythingEste controlador permite que cualquier tipo de elemento o controlador adquiera el control.

El valor por defecto es « PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything », lo que permite la mayoría de los escenarios de toma de control, pero evita, por ejemplo, que dos «PinchHandlers» compitan por los mismos puntos táctiles.

margin : real

El margen más allá de los límites del elemento « parent », dentro del cual un « eventPoint » puede activar este controlador. Por ejemplo, en un « PinchHandler » en el que el « target » es también el « parent », resulta útil establecer este valor en una distancia equivalente, como mínimo, a la mitad del ancho 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 pellizco siga siendo posible. O bien, si se coloca un botón basado en « TapHandler » cerca del borde de la pantalla, puede utilizarse para cumplir con 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.

Rectángulo con un área de margen alrededor para ampliar la detección táctil

parent : Item

El ` Item `, que es el ámbito del controlador; el `Item` en el que se declaró. El controlador gestionará los eventos en nombre de este `Item`, lo que significa que un evento de puntero es relevante si al menos uno de sus ` eventPoints ` tiene lugar dentro del interior del `Item`. Inicialmente, ` target() ` es el mismo, pero se puede reasignar.

Véase también target y QObject::parent().

target : Item

El elemento que manipulará este controlador.

Por defecto, es el mismo que el « parent », es decir, el «Item» en el que se declara el controlador. Sin embargo, a veces puede resultar útil establecer el objetivo en un «Item» diferente, con el fin de gestionar eventos dentro de un «Item» pero manipular otro; o en « null », para desactivar el comportamiento predeterminado y realizar otra acción en su lugar.

Documentación sobre señales

canceled(eventPoint point)

Si este gestor ya ha capturado el point indicado, esta señal se emite cuando otro gestor de punteros o elemento le arrebata la captura.

Nota: El controlador correspondiente es onCanceled.

grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

Esta señal se emite cuando el «grab» ha sufrido algún cambio relevante para este controlador.

El verbo « transition » indica lo que ha ocurrido. El objeto « point » es el punto que se ha seleccionado o deseleccionado.

Los valores válidos para « transition » son:

ConstanteDescripción
PointerDevice.GrabExclusiveEste controlador ha asumido la responsabilidad principal de gestionar el point.
PointerDevice.UngrabExclusiveEste controlador ha cedido su control exclusivo anterior.
PointerDevice.CancelGrabExclusiveEl control exclusivo de este controlador ha sido asumido por otro o se ha cancelado.
PointerDevice.GrabPassiveEste controlador ha adquirido un control pasivo para supervisar el point.
PointerDevice.UngrabPassiveEste controlador ha cedido su control pasivo anterior.
PointerDevice.CancelGrabPassiveEl control pasivo anterior de este controlador ha finalizado de forma anómala.

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.