En esta página

QAbstract3DInputHandler Class

La clase base para las implementaciones de los controladores de entrada. Más información...

Encabezado: #include <QAbstract3DInputHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: AbstractInputHandler3D
Heredado de: QObject
Heredado por:

Q3DInputHandler

Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum InputView { InputViewNone, InputViewOnPrimary, InputViewOnSecondary }

Propiedades

Funciones públicas

virtual ~QAbstract3DInputHandler()
QPoint inputPosition() const
QAbstract3DInputHandler::InputView inputView() const
virtual void mouseDoubleClickEvent(QMouseEvent *event)
virtual void mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Q3DScene *scene() const
void setInputPosition(const QPoint &position)
void setInputView(QAbstract3DInputHandler::InputView inputView)
void setScene(Q3DScene *scene)
virtual void touchEvent(QTouchEvent *event)
virtual void wheelEvent(QWheelEvent *event)

Señales

void inputViewChanged(QAbstract3DInputHandler::InputView view)
void positionChanged(const QPoint &position)
void sceneChanged(Q3DScene *scene)

Funciones protegidas

QAbstract3DInputHandler(QObject *parent = nullptr)
int prevDistance() const
QPoint previousInputPos() const
void setPrevDistance(int distance)
void setPreviousInputPos(const QPoint &position)

Descripción detallada

QAbstract3DInputHandler es la clase base de la que derivan diferentes implementaciones de gestión de entradas que recogen eventos de entrada y los traducen en movimientos de cámara y de luz. Los gestores de entradas también traducen los eventos de entrada sin procesar en eventos de corte y selección en la escena.

Documentación de los tipos de miembros

enum QAbstract3DInputHandler::InputView

Vistas de entrada predefinidas para controladores de entrada basados en ratón y en pantalla táctil.

ConstanteValorDescripción
QAbstract3DInputHandler::InputViewNone0El ratón o el tacto no se encuentran en una vista.
QAbstract3DInputHandler::InputViewOnPrimary1Se ha recibido una entrada de ratón o táctil en el área de vista principal. Si se muestra una vista secundaria cuando « inputView » pasa a ser «InputViewOnPrimary», la vista secundaria se cierra.
QAbstract3DInputHandler::InputViewOnSecondary2Se ha recibido una entrada del ratón o táctil en el área de la vista secundaria.

Documentación de la propiedad

inputPosition : QPoint

Esta propiedad almacena la última posición de entrada en función de los eventos de entrada procesados.

Funciones de acceso:

QPoint inputPosition() const
void setInputPosition(const QPoint &position)

Señal de notificación:

void positionChanged(const QPoint &position)

inputView : InputView

Esta propiedad contiene la vista de entrada enumerada actual, basada en la vista de los eventos de entrada procesados.

Uno de los valores de la enumeración « InputView ».

Cuando cambia la vista, se emite la señal « inputViewChanged ».

Funciones de acceso:

QAbstract3DInputHandler::InputView inputView() const
void setInputView(QAbstract3DInputHandler::InputView inputView)

Señal de notificación:

void inputViewChanged(QAbstract3DInputHandler::InputView view)

Véase también InputView.

scene : Q3DScene*

Esta propiedad contiene la escena 3D que controla este gestor de entradas abstracto.

Un controlador de entrada puede controlar una escena. Asignar una escena a un controlador de entrada no transfiere la propiedad de la escena.

Funciones de acceso:

Q3DScene *scene() const
void setScene(Q3DScene *scene)

Señal de notificación:

void sceneChanged(Q3DScene *scene)

Documentación de las funciones de miembro

[explicit protected] QAbstract3DInputHandler::QAbstract3DInputHandler(QObject *parent = nullptr)

Crea la clase base. Se puede proporcionar un parámetro opcional de tipo « parent », que se pasa al constructor de « QObject ».

[virtual noexcept] QAbstract3DInputHandler::~QAbstract3DInputHandler()

Elimina la clase base.

[virtual] void QAbstract3DInputHandler::mouseDoubleClickEvent(QMouseEvent *event)

Sobrescribe este método para gestionar los eventos de doble clic del ratón. El evento de doble clic del ratón se define en ` event`.

[virtual] void QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)

Sobrescribe este método para gestionar los eventos de movimiento del ratón. El evento de movimiento del ratón se pasa en ` event ` y la posición del ratón en ` mousePos`.

[virtual] void QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)

Sobrescribe este método para gestionar los eventos de pulsación del ratón. El evento de pulsación del ratón se pasa en ` event ` y la posición del ratón en ` mousePos`.

[virtual] void QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)

Sobrescribe este método para gestionar los eventos de liberación del ratón. El evento de liberación del ratón se pasa en ` event ` y la posición del ratón en ` mousePos`.

[protected] int QAbstract3DInputHandler::prevDistance() const

Devuelve la longitud de Manhattan entre las dos últimas posiciones de entrada.

Véase también setPrevDistance().

[protected] QPoint QAbstract3DInputHandler::previousInputPos() const

Devuelve la posición de entrada anterior.

Véase también setPreviousInputPos().

[protected] void QAbstract3DInputHandler::setPrevDistance(int distance)

Establece la longitud de Manhattan ( distance ) entre las dos últimas posiciones de entrada.

Véase también prevDistance().

[protected] void QAbstract3DInputHandler::setPreviousInputPos(const QPoint &position)

Establece la posición de entrada anterior en el punto indicado por position.

Véase también previousInputPos().

[virtual] void QAbstract3DInputHandler::touchEvent(QTouchEvent *event)

Sobrescribe este método para gestionar los eventos de entrada táctil. El evento táctil se pasa a través de ` event`.

[virtual] void QAbstract3DInputHandler::wheelEvent(QWheelEvent *event)

Sobrescribe este método para gestionar los eventos de la rueda. El evento de la rueda se pasa a través de ` 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.