Trace QML Type (Uncreatable)

Trace est un modèle de données destiné aux données d'entrée tactiles. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié dans QML.

• 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

Trace fournit le modèle de données pour les coordonnées et autres données facultatives associées à un trait unique.

Voici un cas d'utilisation typique de l'objet trace :

• TraceInputArea ou un autre périphérique d'entrée déclenche l'événement trace en appelant la méthode ` InputEngine.traceBegin()`.
• Si la méthode de saisie 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 Elle appelle la méthode ` InputEngine.traceEnd()` pour terminer la trace et renvoie l'objet `trace` à la méthode d'entrée.
• La méthode d’entrée traite les données et supprime 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()`.

Outre les données de coordonnées, il est possible d’associer un canal de données arbitraire à chaque point de données.

Les canaux de données doivent être définis avant l’ajout des points. Les canaux de données pris en charge par la méthode ` TraceInputArea ` sont répertoriés ci-dessous :

• "t" Enregistre l’heure de chaque point de données. L’heure correspond au nombre de millisecondes écoulées depuis le 01/01/1970 :

Par exemple, pour configurer l’objet afin qu’il collecte l’heure de chaque point :

QVirtualKeyboardTrace *trace = new QVirtualKeyboardTrace(this);
trace->setChannels(QStringList() << "t");

Les données collectées sont accessibles via la fonction ` channelData()` :

QVariantList timeData = trace->channelData("t");

Les objets Trace appartiennent à leur créateur, qui est, dans le cas normal, la méthode d’entrée. Cela signifie que les objets sont construits dans la méthode InputMethod.traceBegin() (QML).

Par définition, l’objet de 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é permet de déterminer si la trace est annulée. Les données d'entrée issues des traces dont la propriété « canceled » est définie sur « true » ne doivent pas être traitées.

channels : list<strings>

Liste des canaux de données supplémentaires dans la trace. Cette propriété doit être initialisée avant l'ajout des données.

final : bool

Cette propriété détermine si la trace peut accepter davantage de données. Si la valeur est « true », aucune autre donnée 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 plus faible donne une trace plus transparente : 0.0 est entièrement transparente, tandis que 1.0 est entièrement opaque.

Cette propriété est utile pour rendre les traces plus anciennes plus transparentes à 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 la condition « final » est vraie).

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

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

Si le paramètre ` pos ` est fourni, la fonction renvoie les données à partir de la position indiquée. 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 fourni, la fonction renvoie tous les points.

Si le paramètre ` pos ` est fourni, la fonction renvoie les points à partir de la position indiquée. Le paramètre ` count ` limite le nombre de points renvoyés.

La liste renvoyée contient des types « point ».

void setChannelData(int index, string channel, var data)

Définit la valeur « data » pour le point situé à l'adresse index dans les données fournies 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 ; elles doivent être ajoutées de manière synchrone avec les données des points.

Voir également channelData().

[since 6.1] void startHideTimer(int delayMs)

Lance un minuteur pour ramener l'opacité à zéro après ` delayMs`. Si la fonction est appelée à nouveau avant ` delayMs`, le minuteur est relancé.

Grâce à cette fonction, la méthode d’entrée 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.