En esta página

QOrientationReading Class

La clase QOrientationReading representa una lectura del sensor de orientación. Más...

Cabecera: #include <QOrientationReading>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
Hereda: QSensorReading

Tipos públicos

enum Orientation { Undefined, TopUp, TopDown, LeftUp, RightUp, …, FaceDown }

Propiedades

Funciones públicas

QOrientationReading::Orientation orientation() const
void setOrientation(QOrientationReading::Orientation orientation)

Descripción detallada

El sensor de orientación informa de la orientación del dispositivo. Como funciona por debajo del nivel de la interfaz de usuario, no informa ni sabe cómo está girada la interfaz de usuario. Lo más importante es que esto significa que este sensor no se puede utilizar para detectar si un dispositivo está en modo vertical u horizontal.

Este sensor es útil para detectar que un lado en particular del dispositivo está apuntando hacia arriba.

Unidades QOrientationReading

El sensor de orientación devuelve la orientación del dispositivo usando los valores predefinidos que se encuentran en el enum QOrientationReading::Orientation.

Documentación de tipos de miembros

enum QOrientationReading::Orientation

Este enum representa la orientación del dispositivo.

Para explicar el significado de cada valor es útil consultar el siguiente diagrama.

Las orientaciones se muestran aquí por orden: TopUp, TopDown, LeftUp, RightUp, FaceUp, FaceDown.

ConstanteValorDescripción
QOrientationReading::Undefined0La orientación es desconocida.
QOrientationReading::TopUp1El borde superior del dispositivo apunta hacia arriba.
QOrientationReading::TopDown2El borde superior del dispositivo apunta hacia abajo.
QOrientationReading::LeftUp3El borde izquierdo del dispositivo apunta hacia arriba.
QOrientationReading::RightUp4El borde derecho del dispositivo apunta hacia arriba.
QOrientationReading::FaceUp5La cara del dispositivo apunta hacia arriba.
QOrientationReading::FaceDown6La cara del dispositivo apunta hacia abajo.

Debe tenerse en cuenta que el sensor de orientación informa de la orientación del dispositivo y no de la interfaz de usuario. La orientación del dispositivo no cambiará sólo porque se gire la interfaz de usuario. Esto significa que este sensor no se puede utilizar para detectar si un dispositivo está en modo vertical u horizontal.

Documentación de propiedades

[read-only] orientation : Orientation

Esta propiedad contiene la orientación del dispositivo.

La unidad es una enumeración que describe la orientación del dispositivo.

Funciones de acceso:

QOrientationReading::Orientation orientation() const

Véase también QOrientationReading Units.

Documentación de las funciones miembro

void QOrientationReading::setOrientation(QOrientationReading::Orientation orientation)

Establece la dirección orientation para la lectura.

Véase también orientation().

© 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.