Sur cette page

QSensorReading Class

La classe `QSensorReading` contient les valeurs relevées par le capteur. En savoir plus...

En-tête : #include <QSensorReading>
CMake : find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake : QT += sensors
Hérite de : QObject
Hérité par :
13 types

QAccelerometerReading, QAmbientLightReading, QAmbientTemperatureReading, QCompassReading, QGyroscopeReading, QHumidityReading, QLightReading, QMagnetometerReading, QOrientationReading, QPressureReading, QProximityReading, QRotationReading, et QTiltReading

Propriétés

Fonctions publiques

void setTimestamp(quint64 timestamp)
quint64 timestamp() const
QVariant value(int index) const
int valueCount() const

Macros

DECLARE_READING(classname)
IMPLEMENT_READING(classname)

Description détaillée

Notez que QSensorReading n'est pas particulièrement utile en soi. Les données pertinentes pour chaque capteur sont définies dans une sous-classe de QSensorReading.

Documentation des propriétés

[read-only] timestamp : quint64

Cette propriété contient l'horodatage de la mesure.

Les valeurs d’horodatage sont exprimées en microsecondes à partir d’un point fixe. Vous pouvez utiliser ces horodatages pour déterminer l’écart entre deux relevés de capteurs.

Notez que les horodatages provenant de capteurs différents ne sont pas nécessairement directement comparables (car ceux-ci peuvent utiliser des points de référence différents).

Notez que certaines plateformes ne fournissent pas correctement les horodatages. Les applications doivent être préparées à des problèmes occasionnels pouvant entraîner un décalage des horodatages vers le passé.

Fonctions d'accès :

quint64 timestamp() const

Documentation des fonctions membres

void QSensorReading::setTimestamp(quint64 timestamp)

Définit l'timestamp e de la lecture.

Voir aussi timestamp().

quint64 QSensorReading::timestamp() const

Renvoie l'horodatage de la lecture.

Remarque : fonction de récupération (getter ) pour la propriété timestamp.

Voir aussi setTimestamp().

QVariant QSensorReading::value(int index) const

Renvoie la valeur de la propriété à l'adresse index.

Notez que cette fonction est plus lente que l'appel direct de la fonction data.

Voici un exemple illustrant comment récupérer une propriété via les différents mécanismes disponibles.

L'accès direct offre les meilleures performances, mais nécessite de connaître, au moment de la compilation, les données auxquelles vous accédez.

QAccelerometerReading *reading = ...;
qreal x = reading->x();

Vous pouvez également accéder à une propriété par son nom. Pour ce faire, vous devez appeler ` QObject::property()`.

qreal x = reading->property("x").value<qreal>();

Enfin, vous pouvez accéder aux valeurs via un index numérique.

qreal x = reading->value(0).value<qreal>();

Notez que la fonction `value()` ne peut accéder qu’aux propriétés déclarées avec ` Q_PROPERTY()` dans les sous-classes de ` QSensorReading`.

Voir également ` valueCount()` et ` QObject::property()`.

int QSensorReading::valueCount() const

Renvoie le nombre de propriétés supplémentaires que comporte la lecture.

Notez que cela ne prend pas en compte les propriétés déclarées dans ` QSensorReading`.

À titre d'exemple, cette fonction renvoie 3 pour QAccelerometerReading, car cette classe comporte 3 propriétés.

Documentation des macros

DECLARE_READING(classname)

La macro DECLARE_READING ajoute certaines méthodes obligatoires à une classe de lecture.

Cette macro doit être utilisée pour toutes les classes de lecture. Passez-lui l'classname e de votre classe de lecture.

class MyReadingPrivate;

class MyReading : public QSensorReading
{
    Q_OBJECT
    Q_PROPERTY(qreal myprop READ myprop)
    DECLARE_READING(MyReading)
public:
    qreal myprop() const;
    void setMyprop(qreal myprop);
};

Voir également IMPLEMENT_READING().

IMPLEMENT_READING(classname)

La macro IMPLEMENT_READING implémente les méthodes requises pour une classe de lecture.

Cette macro doit être utilisée pour toutes les classes de lecture. Elle doit être placée dans une seule unité de compilation (fichier source), et non dans un fichier d'en-tête. Passez-lui l'classname e de votre classe de lecture.

IMPLEMENT_READING(MyReading)

Voir également DECLARE_READING().

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