En esta página

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:

QTouch3DInputHandler

Estado: Obsoleto

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

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ónAcción
Arrastrar con el botón derecho pulsadoGira el gráfico dentro de los límites establecidos para « Q3DCamera ».
Clic con el botón izquierdoSelecciona el elemento situado bajo el cursor o deselecciona si no hay ninguno. Puede abrir la vista secundaria dependiendo de selection mode.
Rueda del ratónAcercar 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é visibleCierra 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.