Trace QML Type

Trace es un modelo de datos para los datos de entrada táctil. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Métodos

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

Descripción detallada

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

Un caso de uso típico para el objeto trazo es el siguiente:

• TraceInputArea u otro dispositivo de entrada inicia el evento de trazo llamando al método InputEngine.traceBegin().
• Si el método de entrada actual acepta el evento, crea un objeto de trazo y configura los canales de datos necesarios (si los hay).
• TraceInputArea recoge los datos para el objeto de rastreo.
• TraceInputArea llama al método InputEngine.traceEnd() para finalizar la traza y devuelve el objeto de traza 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 utilizando 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 que admite TraceInputArea:

• "t" Recoge el tiempo para cada punto de datos. La hora es el número de milisegundos transcurridos desde el 01/01/1970:

Por ejemplo, para configurar el objeto para que recoja los tiempos 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 es el método de entrada en el caso normal. Esto significa que los objetos se construyen en el método InputMethod.traceBegin() (QML).

Por definición, el objeto traza puede destruirse cuando se desee en el método InputMethod.traceEnd() (QML).

Documentación de propiedades

canceled : bool

Esta propiedad define si la Traza se cancela. Los datos de entrada no deben procesarse desde las Trazas cuya propiedad canceled tenga el valor 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 de la traza.

Un valor más bajo resulta en un trazo más transparente: 0.0 es completamente transparente, y 1.0 es completamente opaco.

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

Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.4.

traceId : int

Id único de este Trace.

Documentación del método

int addPoint(point point)

Añade un point a la Traza.

El método devuelve el índice del punto añadido, o -1 si los puntos no se pueden añadir (es decir, el final es verdadero).

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

Devuelve los datos de la dirección channel especificada. Si no se indican otros parámetros, la función devuelve todos los datos.

Si se indica el parámetro pos, la función devuelve los datos a partir de la posición. El parámetro count limita el número de elementos devueltos.

Véase también setChannelData().

var points(int pos, int count)

Devuelve una lista de puntos. Si no se da ningún parámetro, la función devuelve todos los puntos.

Si se indica el parámetro pos, la función devuelve los puntos a partir de la posición. El parámetro count limita el número de puntos devueltos.

La lista devuelta contiene los tipos point.

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

Establece data para el punto en index en los datos dados channel.

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

Véase también channelData().

[since 6.1] void startHideTimer(int delayMs)

Inicia un temporizador para poner la opacidad a cero después de delayMs. Si se llama de nuevo dentro de delayMs, el temporizador se reinicia.

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

Este método se introdujo en Qt 6.1.