QVirtualKeyboardTrace Class
Trace es un modelo de datos para los datos de entrada táctil. Más...
| Cabecera: | #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 |
| Hereda: | 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 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 traza y configura los canales de datos necesarios (si los hay).
- TraceInputArea recoge los datos para el objeto Trace.
- TraceInputArea llama al método InputEngine.traceEnd() para finalizar el rastreo y pasa el objeto de rastreo de vuelta 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 recogidos utilizando la función channelData():
QVariantList timeData = trace->channelData("t");
Los objetos QVirtualKeyboardTrace 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 trace puede ser destruido cuando se desee en el método InputMethod.traceEnd() (QML).
Documentación de propiedades
canceled : bool
define si se cancela la QVirtualKeyboardTrace.
Los datos de entrada no deben procesarse a partir de las Trazas cuya propiedad canceled tenga el valor 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 el QQTrace.
Esta propiedad debe inicializarse antes de añadir los datos.
Funciones de acceso:
| QStringList | channels() const |
| void | setChannels(const QStringList &channels) |
Señal del notificador:
| void | channelsChanged() |
final : bool
define si 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 notificadora:
| void | finalChanged(bool isFinal) |
[read-only] length : int
Esta propiedad mantiene el número de puntos en QVirtualKeyboardTrace.
Funciones de acceso:
| int | length() const |
Señal del notificador:
| void | lengthChanged(int length) |
opacity : qreal
Esta propiedad define el grado de opacidad de QVirtualKeyboardTrace.
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 las trazas más antiguas a medida que se añaden otras nuevas.
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 notificador:
| void | traceIdChanged(int traceId) |
Documentación de la función miembro
[invokable] int QVirtualKeyboardTrace::addPoint(const QPointF &point)
Añade un point al QVirtualKeyboardTrace.
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).
Nota: El índice devuelto es necesario para asociar datos adicionales al punto utilizando el método setChannelData().
Nota: Esta función puede invocarse 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 de la dirección channel especificada. Si no se indican otros parámetros, el método devuelve todos los datos.
Si se indica el parámetro pos, el método devuelve los datos a partir de la posición. El parámetro count limita el número de elementos devueltos.
Nota: Esta función puede invocarse 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 da ningún parámetro, el método devuelve todos los datos.
Si se indica el parámetro pos, el método 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 QPointF.
Nota: Esta función puede invocarse 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 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.
Nota: Esta función puede invocarse 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 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.
Nota: Esta función puede invocarse 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.
