QOrientationReading Class
La clase `QOrientationReading` representa una lectura del sensor de orientación. Más información...
| Encabezado: | #include <QOrientationReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Heredado de: | QSensorReading |
Tipos públicos
| enum | Orientation { Undefined, TopUp, TopDown, LeftUp, RightUp, …, FaceDown } |
Propiedades
- orientation : Orientation
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. Dado que 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 resulta útil para detectar si un lado concreto del dispositivo está orientado hacia arriba.
Unidades de lectura de QOrientation
El sensor de orientación devuelve la orientación del dispositivo utilizando los valores predefinidos que se encuentran en la enumeración « QOrientationReading::Orientation ».
Documentación sobre los tipos de miembros
enum QOrientationReading::Orientation
Esta enumeración representa la orientación del dispositivo.
Para explicar el significado de cada valor, resulta útil consultar el siguiente diagrama.

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

| Constante | Valor | Descripción |
|---|---|---|
QOrientationReading::Undefined | 0 | Se desconoce la orientación. |
QOrientationReading::TopUp | 1 | El borde superior del dispositivo apunta hacia arriba. |
QOrientationReading::TopDown | 2 | El borde superior del dispositivo apunta hacia abajo. |
QOrientationReading::LeftUp | 3 | El borde izquierdo del dispositivo apunta hacia arriba. |
QOrientationReading::RightUp | 4 | El borde derecho del dispositivo apunta hacia arriba. |
QOrientationReading::FaceUp | 5 | La parte frontal del dispositivo apunta hacia arriba. |
QOrientationReading::FaceDown | 6 | La pantalla del dispositivo está orientada hacia abajo. |
Cabe señalar que el sensor de orientación indica la orientación del dispositivo y no la de la interfaz de usuario. La orientación del dispositivo no cambiará solo 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 indica 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 de miembro
void QOrientationReading::setOrientation(QOrientationReading::Orientation orientation)
Establece el valor de « 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.