Trace QML Type
Trace ist ein Datenmodell für Touch-Eingabedaten. Mehr...
| Import Statement: | import QtQuick.VirtualKeyboard |
| Since: | QtQuick.VirtualKeyboard 2.0 |
| In C++: | QVirtualKeyboardTrace |
Eigenschaften
- canceled : bool
- channels : list<strings>
- final : bool
- opacity : qreal
(since QtQuick.VirtualKeyboard 2.4) - traceId : int
Methoden
- 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 QtQuick.VirtualKeyboard.Styles 6.1)
Detaillierte Beschreibung
Trace bietet das Datenmodell für Koordinatendaten und andere optionale Daten, die mit einem einzelnen Strich verbunden sind.
Ein typischer Anwendungsfall für das Trace-Objekt ist wie folgt:
- TraceInputArea Die aktuelle Eingabemethode oder ein anderes Eingabegerät initiiert das Trace-Ereignis durch den Aufruf der Methode InputEngine.traceBegin().
- Wenn die aktuelle Eingabemethode das Ereignis annimmt, erstellt sie ein Trace-Objekt und konfiguriert die erforderlichen Datenkanäle (falls vorhanden).
- TraceInputArea sammelt die Daten für das Trace-Objekt.
- TraceInputArea ruft die Methode InputEngine.traceEnd() auf, um den Trace zu beenden und das Trace-Objekt an die Eingabemethode zurückzugeben.
- Die Eingabemethode verarbeitet die Daten und verwirft das Objekt, wenn es nicht mehr benötigt wird.
Die Koordinatendaten werden mit der Funktion points() abgerufen.
Zusätzlich zu den koordinatenbasierten Daten ist es möglich, für jeden Datenpunkt einen beliebigen Datenkanal zu verwenden.
Die Datenkanäle müssen definiert werden, bevor die Punkte hinzugefügt werden. Die von TraceInputArea unterstützten Datenkanäle sind im Folgenden aufgeführt:
"t"Sammelt die Zeit für jeden Datenpunkt. Die Zeit ist die Anzahl der Millisekunden seit 1970/01/01:
Zum Beispiel, um das Objekt so zu konfigurieren, dass die Zeiten für jeden Punkt gesammelt werden:
QVirtualKeyboardTrace *trace = new QVirtualKeyboardTrace(this); trace->setChannels(QStringList() << "t");
Die gesammelten Daten können mit der Funktion channelData() abgerufen werden:
QVariantList timeData = trace->channelData("t");
Trace-Objekte sind Eigentum ihres Erzeugers, der im Normalfall die Eingabemethode ist. Das bedeutet, dass die Objekte in der Methode InputMethod.traceBegin() (QML) erstellt werden.
Per Definition kann das Trace-Objekt frühestens in der Methode InputMethod.traceEnd() (QML) zerstört werden.
Eigenschaft Dokumentation
canceled : bool |
Diese Eigenschaft legt fest, ob der Trace abgebrochen wird. Die Eingangsdaten sollten nicht von den Traces verarbeitet werden, deren canceled Eigenschaft auf true gesetzt ist.
channels : list<strings> |
Liste der zusätzlichen Datenkanäle im Trace. Diese Eigenschaft muss initialisiert werden, bevor die Daten hinzugefügt werden.
final : bool |
Diese Eigenschaft legt fest, ob der Trace weitere Daten akzeptieren kann. Wenn der Wert true ist, werden keine weiteren Daten akzeptiert.
opacity : qreal |
Diese Eigenschaft legt fest, wie undurchsichtig der Trace ist.
Ein niedrigerer Wert ergibt eine transparentere Spur: 0.0 ist vollständig transparent und 1.0 ist vollständig undurchsichtig.
Diese Eigenschaft ist nützlich, um ältere Traces transparenter zu machen, wenn neue hinzugefügt werden.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.4 eingeführt.
traceId : int |
Eindeutige ID dieser Spur.
Methode Dokumentation
Fügt eine point zum Trace hinzu.
Die Methode gibt den Index des hinzugefügten Punktes zurück, oder -1, wenn die Punkte nicht hinzugefügt werden können (d.h. die final ist wahr).
Hinweis: Der zurückgegebene Index wird benötigt, um dem Punkt mit der Funktion setChannelData() zusätzliche Daten zuzuordnen.
Gibt Daten aus dem angegebenen channel zurück. Wenn keine weiteren Parameter angegeben werden, gibt die Funktion alle Daten zurück.
Wenn der Parameter pos angegeben wird, gibt die Funktion Daten ab der Position zurück. Der Parameter count begrenzt, wie viele Elemente zurückgegeben werden.
Siehe auch setChannelData().
Gibt eine Liste von Punkten zurück. Wenn keine Parameter angegeben werden, gibt die Funktion alle Punkte zurück.
Wenn der Parameter pos angegeben wird, gibt die Funktion Punkte zurück, die an der Position beginnen. Der Parameter count begrenzt, wie viele Punkte zurückgegeben werden.
Die zurückgegebene Liste enthält point Typen.
Setzt data für den Punkt an index in den angegebenen Daten channel.
Wenn diese Methode nicht für jeden Datenpunkt aufgerufen wird, werden die Kanaldaten mit leeren Werten aufgefüllt. Die Daten können jedoch nicht an einem beliebigen Index hinzugefügt werden, d. h. sie müssen synchron mit den Punktdaten hinzugefügt werden.
Siehe auch channelData().
|
Startet einen Timer, um die Deckkraft nach delayMs auf Null zu setzen. Bei erneutem Aufruf innerhalb von delayMs wird der Timer neu gestartet.
Mit dieser Funktion kann die Eingabemethode den Trace vom Bildschirm ausblenden, bevor das Trace-Objekt zerstört wird, z.B. um anzuzeigen, dass der Trace verarbeitet wurde.
Diese Methode wurde in QtQuick.VirtualKeyboard.Styles 6.1 eingeführt.
© 2025 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.
