QOrientationReading
Since: 1.0
#include <QtSensors/QOrientationReading>
QtSensors
The QOrientationReading class represents one reading from the orientation sensor.
The orientation sensor reports the orientation of the device. As it operates below the UI level it does not report on or even know how the UI is rotated. Most importantly this means that this sensor cannot be used to detect if a device is in portrait or landscape mode.
This sensor is useful to detect that a particular side of the device is pointing up.
Overview
Inheritance
| QSensorReading | ||
| QOrientationReading | ||
Properties Index
| Orientation | orientation [read-only] |
| QtMobility::qtimestamp | timestamp [read-only] |
Public Functions Index
| Orientation | orientation () const |
| void | setOrientation (Orientation orientation) |
| void | setTimestamp (qtimestamp timestamp) |
| qtimestamp | timestamp () const |
| QVariant | value (int index) const |
| int | valueCount () const |
Protected Functions Index
Only has inherited protected functions
| virtual void | copyValuesFrom (QSensorReading *other) |
| QScopedPointer< QSensorReadingPrivate > * | d_ptr () |
| QSensorReading (QObject *parent, QSensorReadingPrivate *d) |
Public Types
This enum represents the orientation of the device.
To explain the meaning of each value it is helpful to refer to the following diagram.
The orientations are shown here in order: TopUp, TopDown, LeftUp, RightUp, FaceUp, FaceDown.
Undefined The orientation is unknown. TopUp The Top edge of the device is pointing up. TopDown The Top edge of the device is pointing down. LeftUp The Left edge of the device is pointing up. RightUp The Right edge of the device is pointing up. FaceUp The Face of the device is pointing up. FaceDown The Face of the device is pointing down.
It should be noted that the orientation sensor reports the orientation of the device and not the UI. The orientation of the device will not change just because the UI is rotated. This means this sensor cannot be used to detect if a device is in portrait or landscape mode.
- Undefined 0
- TopUp
- TopDown
- LeftUp
- RightUp
- FaceUp
- FaceDown
Properties
QtMobility::qtimestamp timestamp[read-only]
the timestamp of the reading.
Public Functions
void
Sets the orientation for the reading.
1.0
void
Sets the timestamp of the reading.
1.0
QVariant
Returns the value of the property at index.
Note that this function is slower than calling the data function directly.
Here is an example of getting a property via the different mechanisms available.
Accessing directly provides the best performance but requires compile-time knowledge of the data you are accessing.
QAccelerometerReading *reading = ...;
qreal x = reading->x();
You can also access a property by name. To do this you must call QObject::property().
qreal x = reading->property("x").value<qreal>();
Finally, you can access values via numeric index.
qreal x = reading->value(0).value<qreal>();
Note that value() can only access properties declared with Q_PROPERTY() in sub-classes of QSensorReading.
valueCount(), QObject::property()
1.0
int
Returns the number of extra properties that the reading has.
Note that this does not count properties declared in QSensorReading.
1.0
Protected Functions
(Only has inherited protected functions)
© 2013 Digia Plc and/or its subsidiaries. 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.
Documentation sources may be obtained from www.qt-project.org.
Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy