En esta página

QVirtualKeyboardTrace Class

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

Encabezado: #include <QVirtualKeyboardTrace>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
Desde: QtQuick.VirtualKeyboard 2.0
En QML: Trace
Heredado de: QObject

Propiedades

Funciones públicas

int addPoint(const QPointF &point)
QVariantList channelData(const QString &channel, int pos = 0, int count = -1) const
QStringList channels() const
bool isCanceled() const
bool isFinal() const
int length() const
qreal opacity() const
QVariantList points(int pos = 0, int count = -1) const
void setCanceled(bool canceled)
void setChannelData(const QString &channel, int index, const QVariant &data)
void setChannels(const QStringList &channels)
void setFinal(bool final)
void setOpacity(qreal opacity)
void setTraceId(int id)
(since 6.1) void startHideTimer(int delayMs)
int traceId() const

Señales

void canceledChanged(bool isCanceled)
void channelsChanged()
void finalChanged(bool isFinal)
void lengthChanged(int length)
void opacityChanged(qreal opacity)
void traceIdChanged(int traceId)

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 de trazo 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 rastreo 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 asociar un canal de datos arbitrario a 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 `QVirtualKeyboardTrace` 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

Determina si se cancela la opción « QVirtualKeyboardTrace ».

No se deben procesar los datos de entrada procedentes de los «Traces» cuya propiedad « canceled » esté establecida en «true».

Funciones de acceso:

bool isCanceled() const
void setCanceled(bool canceled)

Señal del notificador:

void canceledChanged(bool isCanceled)

channels : QStringList

Lista de canales de datos en QQTrace.

Esta propiedad debe inicializarse antes de añadir los datos.

Funciones de acceso:

QStringList channels() const
void setChannels(const QStringList &channels)

Señal de notificación:

void channelsChanged()

final : bool

Define si el « QVirtualKeyboardTrace » puede aceptar más datos. Si el valor es « true », no se aceptan más datos.

Funciones de acceso:

bool isFinal() const
void setFinal(bool final)

Señal de notificación:

void finalChanged(bool isFinal)

[read-only] length : int

Esta propiedad contiene el número de puntos de la QVirtualKeyboardTrace.

Funciones de acceso:

int length() const

Señal de notificación:

void lengthChanged(int length)

opacity : qreal

Esta propiedad define el grado de opacidad de la QVirtualKeyboardTrace.

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.

Funciones de acceso:

qreal opacity() const
void setOpacity(qreal opacity)

Señal de notificador:

void opacityChanged(qreal opacity)

traceId : int

Identificador único de este QVirtualKeyboardTrace.

Funciones de acceso:

int traceId() const
void setTraceId(int id)

Señal de notificación:

void traceIdChanged(int traceId)

Documentación de las funciones de miembro

[invokable] int QVirtualKeyboardTrace::addPoint(const QPointF &point)

Añade un ` point ` a ` QVirtualKeyboardTrace`.

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

Nota: El índice devuelto es necesario para asociar datos adicionales al punto mediante el método ` setChannelData()`.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QVariantList QVirtualKeyboardTrace::channelData(const QString &channel, int pos = 0, int count = -1) const

Devuelve los datos del ` channel` especificado. Si no se proporcionan otros parámetros, el método devuelve todos los datos.

Si se proporciona el parámetro ` pos `, el método devuelve los datos a partir de esa posición. El parámetro ` count ` limita el número de elementos que se devuelven.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setChannelData().

[invokable] QVariantList QVirtualKeyboardTrace::points(int pos = 0, int count = -1) const

Devuelve una lista de puntos. Si no se especifican parámetros, el método devuelve todos los datos.

Si se proporciona el parámetro ` pos `, el método 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 « QPointF ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QVirtualKeyboardTrace::setChannelData(const QString &channel, int index, const QVariant &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 del punto.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también channelData().

[invokable, since 6.1] void QVirtualKeyboardTrace::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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Esta función 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.