QVirtualKeyboardTrace Class
Trace est un modèle de données pour les données tactiles. Plus d'informations...
| En-tête : | #include <QVirtualKeyboardTrace> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake : | QT += virtualkeyboard |
| Depuis : | QtQuick.VirtualKeyboard 2.0 |
| En QML : | Trace |
| Hérites : | QObject |
Propriétés
Fonctions publiques
| int | addPoint(const QPointF &point) |
| QVariantList | channelData(const QString &channel, int pos = 0, int count = -1) const |
| QStringList | channels() const |
| bool | isCanceled() const |
| bool | isFinal() const |
| int | length() const |
| qreal | opacity() const |
| QVariantList | points(int pos = 0, int count = -1) const |
| void | setCanceled(bool canceled) |
| void | setChannelData(const QString &channel, int index, const QVariant &data) |
| void | setChannels(const QStringList &channels) |
| void | setFinal(bool final) |
| void | setOpacity(qreal opacity) |
| void | setTraceId(int id) |
(since 6.1) void | startHideTimer(int delayMs) |
| int | traceId() const |
Signaux
| void | canceledChanged(bool isCanceled) |
| void | channelsChanged() |
| void | finalChanged(bool isFinal) |
| void | lengthChanged(int length) |
| void | opacityChanged(qreal opacity) |
| void | traceIdChanged(int traceId) |
Description détaillée
L'objet Trace fournit un modèle de données pour les données de coordonnées et d'autres données facultatives associées à un seul trait.
Un cas d'utilisation typique de l'objet trace est le suivant :
- TraceInputArea ou un autre dispositif d'entrée initie l'événement de trace en appelant la méthode InputEngine.traceBegin().
- Si la méthode d'entrée actuelle accepte l'événement, elle crée un objet Trace et configure les canaux de données requis (le cas échéant).
- TraceInputArea collecte les données pour l'objet Trace.
- TraceInputArea appelle la méthode InputEngine.traceEnd() pour terminer la trace et renvoie l'objet Trace à la méthode d'entrée.
- La méthode input traite les données et se débarrasse de l'objet lorsqu'il n'est plus nécessaire.
Les données de coordonnées sont récupérées à l'aide de la fonction points().
En plus des données basées sur les coordonnées, il est possible d'attacher un canal de données arbitraire à chaque point de données.
Les canaux de données doivent être définis avant que les points ne soient ajoutés. Les canaux de données pris en charge par TraceInputArea sont énumérés ci-dessous :
"t"Collecte l'heure pour chaque point de données. Le temps est le nombre de millisecondes depuis le 1970/01/01 :
Par exemple, pour configurer l'objet afin de collecter les heures pour chaque point :
QVirtualKeyboardTrace *trace = new QVirtualKeyboardTrace(this); trace->setChannels(QStringList() << "t");
Les données collectées sont accessibles à l'aide de la fonction channelData() :
QVariantList timeData = trace->channelData("t");
Les objets QVirtualKeyboardTrace appartiennent à leur créateur, qui est la méthode d'entrée dans le cas normal. Cela signifie que les objets sont construits dans la méthode InputMethod.traceBegin() (QML).
Par définition, l'objet trace peut être détruit au plus tôt dans la méthode InputMethod.traceEnd() (QML).
Documentation sur les propriétés
canceled : bool
définit si le site QVirtualKeyboardTrace est annulé.
Les données d'entrée ne doivent pas être traitées à partir des traces dont la propriété canceled est réglée sur true.
Fonctions d'accès :
| bool | isCanceled() const |
| void | setCanceled(bool canceled) |
Signal de notification :
| void | canceledChanged(bool isCanceled) |
channels : QStringList
liste des canaux de données dans le QQTrace.
Cette propriété doit être initialisée avant que les données ne soient ajoutées.
Fonctions d'accès :
| QStringList | channels() const |
| void | setChannels(const QStringList &channels) |
Signal de notification :
| void | channelsChanged() |
final : bool
définit si le site QVirtualKeyboardTrace peut accepter d'autres données. Si la valeur est true, aucune donnée supplémentaire n'est acceptée.
Fonctions d'accès :
| bool | isFinal() const |
| void | setFinal(bool final) |
Signal de notification :
| void | finalChanged(bool isFinal) |
[read-only] length : int
Cette propriété contient le nombre de points dans QVirtualKeyboardTrace.
Fonctions d'accès :
| int | length() const |
Signal de notification :
| void | lengthChanged(int length) |
opacity : qreal
Cette propriété définit le degré d'opacité du site QVirtualKeyboardTrace.
Une valeur inférieure se traduit par une trace plus transparente : 0.0 est totalement transparent et 1.0 est totalement opaque.
Cette propriété est utile pour rendre les anciennes traces plus transparentes au fur et à mesure que de nouvelles sont ajoutées.
Fonctions d'accès :
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Signal Notificateur :
| void | opacityChanged(qreal opacity) |
traceId : int
l'identifiant unique de ce site QVirtualKeyboardTrace.
Fonctions d'accès :
| int | traceId() const |
| void | setTraceId(int id) |
Signal du notificateur :
| void | traceIdChanged(int traceId) |
Fonction membre Documentation
[invokable] int QVirtualKeyboardTrace::addPoint(const QPointF &point)
Ajoute un point point au point QVirtualKeyboardTrace.
La méthode renvoie l'index du point ajouté, ou -1 si les points ne peuvent pas être ajoutés (c'est-à-dire si final est vrai).
Remarque : l'indice renvoyé est nécessaire pour associer des données supplémentaires au point à l'aide de la méthode setChannelData().
Remarque : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QVariantList QVirtualKeyboardTrace::channelData(const QString &channel, int pos = 0, int count = -1) const
Renvoie les données de l'adresse channel spécifiée. Si aucun autre paramètre n'est fourni, la méthode renvoie toutes les données.
Si le paramètre pos est indiqué, la méthode renvoie les données à partir de la position. Le paramètre count limite le nombre d'éléments renvoyés.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setChannelData().
[invokable] QVariantList QVirtualKeyboardTrace::points(int pos = 0, int count = -1) const
Renvoie une liste de points. Si aucun paramètre n'est fourni, la méthode renvoie toutes les données.
Si le paramètre pos est indiqué, la méthode renvoie les points à partir de la position. Le paramètre count limite le nombre de points renvoyés.
La liste renvoyée contient les types QPointF.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardTrace::setChannelData(const QString &channel, int index, const QVariant &data)
Définit data pour le point situé à index dans les données données channel.
Si cette méthode n'est pas appelée pour chaque point de données, les données du canal seront complétées par des valeurs vides. Cependant, les données ne peuvent pas être ajoutées à un index arbitraire, c'est-à-dire qu'elles doivent être ajoutées de manière synchrone avec les données du point.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également channelData().
[invokable, since 6.1] void QVirtualKeyboardTrace::startHideTimer(int delayMs)
Lance une minuterie pour ramener l'opacité à zéro après delayMs. Si elle est appelée à nouveau dans le délai de delayMs, la minuterie est redémarrée.
Grâce à cette fonction, la méthode de saisie peut masquer la trace à l'écran avant de détruire l'objet trace, par exemple pour indiquer que la trace a été traitée.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Cette fonction a été introduite dans Qt 6.1.
© 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.
