En esta página

Trace QML Type (Uncreatable)

Trace es un modelo de datos para datos de entrada táctil. Más información...

Import Statement: import QtQuick.VirtualKeyboard
Since: QtQuick.VirtualKeyboard 2.0
In C++: QVirtualKeyboardTrace

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Métodos

Descripción detallada

Trace proporciona el modelo de datos para los datos de coordenadas y otros datos opcionales asociados a un único trazo.

Un caso de uso típico del objeto «trace» es el siguiente:

  • TraceInputArea o cualquier otro dispositivo de entrada inicia el evento «trace» llamando al método ` InputEngine.traceBegin()`.
  • Si el método de entrada actual acepta el evento, crea un objeto «trace» y configura los canales de datos necesarios (si los hay).
  • TraceInputArea Recopila los datos para el objeto `trace`.
  • TraceInputArea Llama al método ` InputEngine.traceEnd()` para finalizar el trazo y devuelve el objeto `trace` al método de entrada.
  • El método de entrada procesa los datos y descarta el objeto cuando ya no es necesario.

Los datos de coordenadas se recuperan mediante la función « points()».

Además de los datos basados en coordenadas, es posible adjuntar un canal de datos arbitrario para cada punto de datos.

Los canales de datos deben definirse antes de añadir los puntos. A continuación se enumeran los canales de datos compatibles con ` TraceInputArea `:

  • "t" Recoge la hora de cada punto de datos. La hora es el número de milisegundos transcurridos desde el 1 de enero de 1970:

Por ejemplo, para configurar el objeto para que recopile las horas de cada punto:

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

Se puede acceder a los datos recopilados mediante la función ` channelData()`:

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

Los objetos «trace» son propiedad de su creador, que normalmente es el método de entrada. Esto significa que los objetos se crean en el método « InputMethod.traceBegin()» (QML).

Por definición, el objeto de seguimiento puede destruirse, como muy pronto, en el método InputMethod.traceEnd() (QML).

Documentación de la propiedad

canceled : bool

Esta propiedad define si el seguimiento se cancela. No se deben procesar los datos de entrada procedentes de los seguimientos cuya propiedad « canceled » esté establecida en «true».

channels : list<strings>

Lista de canales de datos adicionales en el Trace. Esta propiedad debe inicializarse antes de añadir los datos.

final : bool

Esta propiedad define si el Trace puede aceptar más datos. Si el valor es « true », no se aceptan más datos.

opacity : real [since QtQuick.VirtualKeyboard 2.4]

Esta propiedad define el grado de opacidad del trazo.

Un valor más bajo da como resultado un trazo más transparente: « 0.0 » es totalmente transparente, y « 1.0 » es totalmente opaco.

Esta propiedad resulta útil para hacer que los trazos más antiguos sean más transparentes a medida que se añaden otros nuevos.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.4.

traceId : int

Identificador único de este rastreo.

Documentación del método

int addPoint(point point)

Añade un « point » al «Trace».

El método devuelve el índice del punto añadido, o -1 si no se pueden añadir los puntos (es decir, si la condición « final » es verdadera).

Nota: El índice devuelto es necesario para asociar datos adicionales al punto mediante la función ` setChannelData()`.

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

Devuelve los datos del ` channel` especificado. Si no se proporcionan otros parámetros, la función devuelve todos los datos.

Si se especifica el parámetro ` pos `, la función devuelve los datos a partir de dicha posición. El parámetro ` count ` limita el número de elementos que se devuelven.

Véase también setChannelData().

var points(int pos, int count)

Devuelve una lista de puntos. Si no se especifican parámetros, la función devuelve todos los puntos.

Si se proporciona el parámetro « pos », la función devuelve los puntos a partir de esa posición. El parámetro « count » limita el número de puntos que se devuelven.

La lista devuelta contiene tipos point.

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

Establece ` data ` para el punto situado en ` index ` en los datos proporcionados ` channel`.

Si no se invoca este método para cada punto de datos, los datos del canal se rellenarán con valores vacíos. Sin embargo, los datos no se pueden añadir en un índice arbitrario, es decir, deben añadirse de forma sincronizada con los datos de los puntos.

Véase también channelData().

[since 6.1] void startHideTimer(int delayMs)

Inicia un temporizador para establecer la opacidad en cero tras ` delayMs`. Si se vuelve a llamar a esta función dentro de ` delayMs`, el temporizador se reinicia.

Con esta función, el método de entrada puede ocultar el rastro de la pantalla antes de destruir el objeto de rastro, por ejemplo, para indicar que el rastro se ha procesado.

Este método se introdujo en 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.