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
Orientation
the orientation of the device.
The unit is an enumeration describing the orientation of the device.
{QOrientationReading Units}
1.0
QtMobility::qtimestamp timestamp[read-only]
the timestamp of the reading.
Returns the timestamp of the reading.
1.0
,1.0
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)
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia. Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.