Q3DInputHandler Class
Manejo básico de entradas mediante el ratón con rueda. Más...
| Encabezado: | #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 |
| Heredado de: | QAbstract3DInputHandler |
| Heredado por: | |
| Estado: | Obsoleto |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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 gestor de entrada básico para dispositivos de entrada del tipo ratón con rueda.
El controlador de entrada predeterminado tiene las siguientes funcionalidades:
| Acción del ratón | Acción |
|---|---|
| Arrastrar con el botón derecho pulsado | Gira el gráfico dentro de los límites establecidos para « Q3DCamera ». |
| Clic con el botón izquierdo | Selecciona el elemento situado bajo el cursor o deselecciona si no hay ninguno. Puede abrir la vista secundaria dependiendo de selection mode. |
| Rueda del ratón | Acercar o alejar la imagen dentro del rango de zoom permitido establecido para Q3DCamera. |
| Hacer clic con el botón izquierdo en la vista principal cuando la vista secundaria esté visible | Cierra la vista secundaria. Nota: La vistasecundaria solo está disponible para los gráficos de « Q3DBars » y « Q3DSurface ». |
La rotación, el zoom y la selección se pueden desactivar individualmente mediante las propiedades correspondientes de esta clase.
Documentación de propiedades
[since QtDataVisualization 1.2] rotationEnabled : bool
Esta propiedad indica si este controlador de entrada permite la rotación de gráficos.
El valor por defecto es « true ».
Esta enumeración se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isRotationEnabled() const |
| void | setRotationEnabled(bool enable) |
Señal de notificación:
| void | rotationEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] selectionEnabled : bool
Esta propiedad indica si este controlador de entrada permite la selección en el gráfico.
El valor por defecto es « true ».
Esta enumeración 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 determina si al ampliar o reducir la imagen se debe cambiar el punto de enfoque de la cámara, de modo que el punto ampliado del gráfico permanezca en la misma posición tras el cambio de escala.
El valor por defecto es « true ».
Esta enumeración 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 controlador de entrada permite el zoom en el gráfico.
El valor por defecto es « true ».
Esta enumeración se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Señal de notificador:
| void | zoomEnabledChanged(bool enable) |
Documentación de las funciones miembro
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Crea el controlador básico de entradas del ratón. Se puede proporcionar un parámetro opcional ` parent `, que se pasa al constructor ` QObject `.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Elimina el controlador de entrada.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplementa: QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Sobrescribe esta función para modificar el manejo de los eventos de movimiento del ratón. El evento de movimiento del ratón se proporciona 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).
Sobrescribe esta función para modificar el manejo de los eventos de pulsación del ratón. El evento de pulsación del ratón se proporciona en ` event ` y la posición del ratón en ` mousePos`.
[override virtual] void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplementa: QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos).
Sobrescribe esta función para modificar el manejo de los eventos de liberación del ratón. El evento de liberación del ratón se proporciona en ` event ` y la posición del ratón en ` mousePos`.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Reimplementa: QAbstract3DInputHandler::wheelEvent(QWheelEvent *event).
Sobrescribe esta función para modificar el tratamiento de los eventos de la rueda. El evento de la rueda se pasa 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.