Auf dieser Seite

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

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

Gerät mit beschrifteten Kanten: oben, links, rechts und Vorderseite

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

Das Gerät wird in den Ausrichtungen „TopUp“, „TopDown“, „LeftUp“, „RightUp“, „FaceUp“ und „FaceDown“ dargestellt

KonstanteWertBeschreibung
QOrientationReading::Undefined0Die Ausrichtung ist unbekannt.
QOrientationReading::TopUp1Die Oberkante des Geräts zeigt nach oben.
QOrientationReading::TopDown2Die Oberkante des Geräts zeigt nach unten.
QOrientationReading::LeftUp3Die linke Kante des Geräts zeigt nach oben.
QOrientationReading::RightUp4Die rechte Kante des Geräts zeigt nach oben.
QOrientationReading::FaceUp5Die Vorderseite des Geräts zeigt nach oben.
QOrientationReading::FaceDown6Die 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.