Q3DInputHandler Class
Manejador de entrada básico basado en la rueda del ratón. Más...
| Cabecera: | #include <Q3DInputHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | InputHandler3D |
| Hereda de: | QAbstract3DInputHandler |
| Heredado de: |
Propiedades
(since QtDataVisualization 1.2)rotationEnabled : bool(since QtDataVisualization 1.2)selectionEnabled : bool(since QtDataVisualization 1.2)zoomAtTargetEnabled : bool(since QtDataVisualization 1.2)zoomEnabled : bool
Funciones públicas
| Q3DInputHandler(QObject *parent = nullptr) | |
| virtual | ~Q3DInputHandler() |
| bool | isRotationEnabled() const |
| bool | isSelectionEnabled() const |
| bool | isZoomAtTargetEnabled() const |
| bool | isZoomEnabled() const |
| void | setRotationEnabled(bool enable) |
| void | setSelectionEnabled(bool enable) |
| void | setZoomAtTargetEnabled(bool enable) |
| void | setZoomEnabled(bool enable) |
Funciones públicas reimplementadas
| virtual void | mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | mousePressEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Señales
| void | rotationEnabledChanged(bool enable) |
| void | selectionEnabledChanged(bool enable) |
| void | zoomAtTargetEnabledChanged(bool enable) |
| void | zoomEnabledChanged(bool enable) |
Descripción Detallada
Q3DInputHandler es el manejador de entrada básico para dispositivos de entrada del tipo ratón con rueda.
El manejador de entrada por defecto tiene las siguientes funcionalidades:
| Acción del ratón | Acción |
|---|---|
| Arrastrar con el botón derecho pulsado | Rota el gráfico dentro de los límites establecidos para Q3DCamera. |
| Clic izquierdo | Selecciona el elemento bajo el cursor o elimina la selección si no hay ninguna. Puede abrir la vista secundaria dependiendo de selection mode. |
| Rueda del ratón | Acercar/alejar el zoom dentro de los límites establecidos para Q3DCamera. |
| Clic izquierdo en la vista primaria cuando la vista secundaria está visible | Cierra la vista secundaria. Nota: La vista secundaria sólo está disponible para los gráficos Q3DBars y Q3DSurface. |
La rotación, el zoom y la selección pueden desactivarse individualmente utilizando las propiedades correspondientes de esta clase.
Documentación de Propiedades
[since QtDataVisualization 1.2] rotationEnabled : bool
Esta propiedad indica si este manejador de entrada permite la rotación del gráfico.
Por defecto es true.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isRotationEnabled() const |
| void | setRotationEnabled(bool enable) |
Señal de notificador:
| void | rotationEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] selectionEnabled : bool
Esta propiedad indica si este manejador de entrada permite la selección desde el gráfico.
Por defecto es true.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isSelectionEnabled() const |
| void | setSelectionEnabled(bool enable) |
Señal de notificador:
| void | selectionEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomAtTargetEnabled : bool
Esta propiedad mantiene si el zoom debe cambiar el objetivo de la cámara para que el punto ampliado del gráfico permanezca en la misma ubicación después del zoom.
Por defecto es true.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isZoomAtTargetEnabled() const |
| void | setZoomAtTargetEnabled(bool enable) |
Señal de notificador:
| void | zoomAtTargetEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomEnabled : bool
Esta propiedad indica si este manejador de entrada permite hacer zoom en el gráfico.
Por defecto es true.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Notifier signal:
| void | zoomEnabledChanged(bool enable) |
Documentación de la Función Miembro
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Construye el controlador básico de entrada del ratón. Se puede dar un parámetro opcional parent que se pasa al constructor QObject.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Destruye el manejador de entrada.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplementa: QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Sobreescribe esto para cambiar el manejo de los eventos de movimiento del ratón. El evento de movimiento del ratón se da en event y la posición del ratón en mousePos.
[override virtual] void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplementa: QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos).
Sobreescribe esto para cambiar el manejo de los eventos de pulsación del ratón. El evento de presion del raton se da en event y la posicion del raton en mousePos.
[override virtual] void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplementa: QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos).
Sobreescribe esto para cambiar el manejo de los eventos de liberación del ratón. El evento de liberación del ratón se da en event y la posición del ratón en mousePos.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Reimplementa: QAbstract3DInputHandler::wheelEvent(QWheelEvent *event).
Sobreescribe esto para cambiar el manejo de los eventos de rueda. El evento rueda se indica en event.
© 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.
