Sur cette page

QOrientationReading Class

La classe `QOrientationReading` représente une mesure provenant du capteur d'orientation. En savoir plus...

En-tête : #include <QOrientationReading>
CMake : find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake : QT += sensors
Hérite de : QSensorReading

Types publics

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

Propriétés

Fonctions publiques

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

Description détaillée

Le capteur d'orientation indique l'orientation de l'appareil. Comme il fonctionne en dessous du niveau de l'interface utilisateur, il ne fournit aucune information sur la rotation de celle-ci et n'en a même pas connaissance. Cela signifie surtout que ce capteur ne peut pas être utilisé pour détecter si un appareil est en mode portrait ou paysage.

Ce capteur est utile pour détecter si un côté particulier de l'appareil est orienté vers le haut.

Unités de mesure de QOrientationReading

Le capteur d'orientation renvoie l'orientation de l'appareil à l'aide des valeurs prédéfinies figurant dans l'énumération QOrientationReading::Orientation.

Documentation sur les types de membres

enum QOrientationReading::Orientation

Cette énumération représente l'orientation de l'appareil.

Pour comprendre la signification de chaque valeur, il est utile de se reporter au schéma suivant.

Appareil dont les bords supérieur, gauche, droit et avant sont identifiés

Les orientations sont présentées ici dans l'ordre suivant : TopUp, TopDown, LeftUp, RightUp, FaceUp, FaceDown.

Appareil présenté dans les orientations suivantes : vers le haut, vers le bas, vers la gauche, vers la droite, face vers le haut et face vers le bas

ConstanteValeurDescription
QOrientationReading::Undefined0L’orientation est inconnue.
QOrientationReading::TopUp1Le bord supérieur de l’appareil est orienté vers le haut.
QOrientationReading::TopDown2Le bord supérieur de l'appareil est orienté vers le bas.
QOrientationReading::LeftUp3Le bord gauche de l'appareil est orienté vers le haut.
QOrientationReading::RightUp4Le bord droit de l'appareil est orienté vers le haut.
QOrientationReading::FaceUp5La face avant de l'appareil est orientée vers le haut.
QOrientationReading::FaceDown6La face avant de l'appareil est orientée vers le bas.

Il convient de noter que le capteur d'orientation indique l'orientation de l'appareil et non celle de l'interface utilisateur. L'orientation de l'appareil ne change pas simplement parce que l'interface utilisateur est pivotée. Cela signifie que ce capteur ne peut pas être utilisé pour détecter si un appareil est en mode portrait ou paysage.

Documentation sur les propriétés

[read-only] orientation : Orientation

Cette propriété contient l'orientation de l'appareil.

L'unité est une énumération décrivant l'orientation de l'appareil.

Fonctions d'accès :

QOrientationReading::Orientation orientation() const

Voir également QOrientationReading Units.

Documentation des fonctions membres

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

Définit l'orientation e de lecture.

Voir aussi 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.