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.