The QFeedbackActuator class describes actuators for tactile feedback. More...
#include <QFeedbackActuator>
Inherits: QObject.
This class was introduced in Qt Mobility 1.1.
enum | Capability { Envelope, Period } |
enum | State { Busy, Ready, Unknown } |
QFeedbackActuator ( QObject * parent = 0 ) | |
int | id () const |
bool | isCapabilitySupported ( Capability capability ) const |
bool | isEnabled () const |
bool | isValid () const |
QString | name () const |
void | setEnabled ( bool enabled ) |
State | state () const |
bool | operator== ( const QFeedbackActuator & other ) const |
void | enabledChanged () |
QList<QFeedbackActuator *> | actuators () |
The QFeedbackActuator class describes actuators for tactile feedback.
An actuator knows how to play a tactile effect. The class gives access to a specified actuator.
An actuator can be used to play QFeedbackHapticsEffects using setActuator(). Usually, you will not have to set an actuator directly on a QFeedbackHapticsEffect. QFeedbackHapticsEffect and QFeedbackFileEffect uses an appropriate actuator by default. However, you can query which actuators are available with actuators().
QFeedbackActuator actuator; // default system actuator QList<QFeedbackActuator> actuators = QFeedbackActuator::actuators(); foreach (const QFeedbackActuator& temp, actuators) { if (temp.name() == "ExampleActuatorName") { actuator = temp; } }
The QFeedbackActuator class gives access to information about the actuator it represents. You can query if the actuator is enabled and if it is valid . Whether an actuator is ready to play an effect can be queried by checking the actuator's state(). The State enum describes the states and actuator can have. You can also get a human readable name for the actuator with the name() function.
See also QFeedbackHapticsEffect, QFeedbackFileEffect, and QFeedbackEffect.
Constant | Value | Description |
---|---|---|
QFeedbackActuator::Envelope | 0 | Capability defining the wave type with attack/fade times and levels. |
QFeedbackActuator::Period | 1 | Capability defining that the device can play periodic effects. |
Constant | Value | Description |
---|---|---|
QFeedbackActuator::Busy | 0 | The actuator is busy. |
QFeedbackActuator::Ready | 1 | The actuator is ready to play an effect. |
QFeedbackActuator::Unknown | 2 | The actuator is in an unknown state. |
This property holds whether the feedback actuator is enabled.
Access functions:
bool | isEnabled () const |
void | setEnabled ( bool enabled ) |
Notifier signal:
void | enabledChanged () |
This property holds id of the feedback actuator.
Access functions:
int | id () const |
This property holds name of the feedback actuator.
Access functions:
QString | name () const |
This property holds state of the feedback actuator.
Access functions:
State | state () const |
This property holds validity of the feedback actuator.
Access functions:
bool | isValid () const |
Constructs a QFeedbackActuator, passing parent to the QObject constructor.
The object will represent the default actuator on the system. If there are no actuators attached to the system, isValid() will return false.
See also isValid().
Returns the list of actuators available on the system.
This signal is emitted when the actuator is requested to enable or disable itself.
This function was introduced in Qt Mobility 1.1.
See also isEnabled().
Returns if the actuator supports the supplied capability.
This function was introduced in Qt Mobility 1.1.
Returns true if this actuator is equal to other.
This function was introduced in Qt Mobility 1.1.
© 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.