En esta página

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

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.

Dispositivo con los bordes superior, izquierdo, derecho y frontal etiquetados

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

Dispositivo mostrado en las orientaciones «TopUp», «TopDown», «LeftUp», «RightUp», «FaceUp» y «FaceDown»

ConstanteValorDescripción
QOrientationReading::Undefined0Se desconoce la orientación.
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 parte frontal del dispositivo apunta hacia arriba.
QOrientationReading::FaceDown6La 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.