Trace QML Type

Trace est un modèle de données pour les données tactiles. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• canceled : bool
• channels : list<strings>
• final : bool
• opacity : real (since QtQuick.VirtualKeyboard 2.4)
• traceId : int

Méthodes

• int addPoint(point point)
• var channelData(string channel, int pos, int count)
• var points(int pos, int count)
• void setChannelData(int index, string channel, var data)
• void startHideTimer(int delayMs) (since 6.1)

Description détaillée

L'objet Trace fournit le 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 de traçage
• TraceInputArea appelle la méthode InputEngine.traceEnd() pour terminer la trace et renvoie l'objet de 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 Trace 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

Cette propriété définit si la trace est annulée. Les données d'entrée ne doivent pas être traitées à partir des traces dont la propriété canceled est définie sur true.

channels : list<strings>

Liste des canaux de données supplémentaires dans la trace. Cette propriété doit être initialisée avant que les données ne soient ajoutées.

final : bool

Cette propriété définit si la trace peut accepter d'autres données. Si la valeur est true, aucune donnée supplémentaire n'est acceptée.

opacity : real [since QtQuick.VirtualKeyboard 2.4]

Cette propriété définit le degré d'opacité de la trace.

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.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.4.

traceId : int

Identifiant unique de cette trace.

Documentation de la méthode

int addPoint(point point)

Ajoute un point à la trace.

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

var channelData(string channel, int pos, int count)

Renvoie les données de l'adresse channel spécifiée. Si aucun autre paramètre n'est indiqué, la fonction renvoie toutes les données.

Si le paramètre pos est indiqué, la fonction renvoie les données à partir de la position. Le paramètre count limite le nombre d'éléments renvoyés.

Voir également setChannelData().

var points(int pos, int count)

Renvoie une liste de points. Si aucun paramètre n'est donné, la fonction renvoie tous les points.

Si le paramètre pos est indiqué, la fonction 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 point.

void setChannelData(int index, string channel, var 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.

Voir également channelData().

[since 6.1] void 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.

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

Cette méthode a été introduite dans Qt 6.1.