QOrientationReading Class
Die Klasse „QOrientationReading“ repräsentiert einen Messwert des Orientierungssensors. Mehr...
| Header: | #include <QOrientationReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Erbt von: | QSensorReading |
Öffentliche Typen
| enum | Orientation { Undefined, TopUp, TopDown, LeftUp, RightUp, …, FaceDown } |
Eigenschaften
- orientation : Orientation
Öffentliche Funktionen
| QOrientationReading::Orientation | orientation() const |
| void | setOrientation(QOrientationReading::Orientation orientation) |
Ausführliche Beschreibung
Der Orientierungssensor meldet die Ausrichtung des Geräts. Da er unterhalb der UI-Ebene arbeitet, gibt er keine Auskunft darüber, wie die Benutzeroberfläche gedreht ist, und weiß dies auch nicht. Das bedeutet vor allem, dass dieser Sensor nicht dazu verwendet werden kann, zu erkennen, ob sich ein Gerät im Hoch- oder Querformat befindet.
Dieser Sensor ist nützlich, um zu erkennen, ob eine bestimmte Seite des Geräts nach oben zeigt.
QOrientationReading-Einheiten
Der Orientierungssensor gibt die Ausrichtung des Geräts anhand der vordefinierten Werte aus der Enumeration „ QOrientationReading::Orientation “ zurück.
Dokumentation zu den Mitgliedstypen
enum QOrientationReading::Orientation
Diese Enumeration gibt die Ausrichtung des Geräts an.
Um die Bedeutung der einzelnen Werte zu erläutern, ist es hilfreich, sich das folgende Diagramm anzusehen.

Die Ausrichtungen sind hier in folgender Reihenfolge dargestellt: TopUp, TopDown, LeftUp, RightUp, FaceUp, FaceDown.

| Konstante | Wert | Beschreibung |
|---|---|---|
QOrientationReading::Undefined | 0 | Die Ausrichtung ist unbekannt. |
QOrientationReading::TopUp | 1 | Die Oberkante des Geräts zeigt nach oben. |
QOrientationReading::TopDown | 2 | Die Oberkante des Geräts zeigt nach unten. |
QOrientationReading::LeftUp | 3 | Die linke Kante des Geräts zeigt nach oben. |
QOrientationReading::RightUp | 4 | Die rechte Kante des Geräts zeigt nach oben. |
QOrientationReading::FaceUp | 5 | Die Vorderseite des Geräts zeigt nach oben. |
QOrientationReading::FaceDown | 6 | Die Vorderseite des Geräts zeigt nach unten. |
Es ist zu beachten, dass der Orientierungssensor die Ausrichtung des Geräts und nicht die der Benutzeroberfläche meldet. Die Ausrichtung des Geräts ändert sich nicht, nur weil die Benutzeroberfläche gedreht wird. Das bedeutet, dass dieser Sensor nicht dazu verwendet werden kann, um festzustellen, ob sich ein Gerät im Hoch- oder Querformat befindet.
Dokumentation der Eigenschaften
[read-only] orientation : Orientation
Diese Eigenschaft gibt die Ausrichtung des Geräts an.
Die Einheit ist eine Aufzählung, die die Ausrichtung des Geräts beschreibt.
Zugriffsfunktionen:
| QOrientationReading::Orientation | orientation() const |
Siehe auch „ QOrientationReading Units “.
Dokumentation zu den Mitgliedsfunktionen
void QOrientationReading::setOrientation(QOrientationReading::Orientation orientation)
Legt die „ orientation “ für den Lesevorgang fest.
Siehe auch 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.