En esta página

TraceCanvas QML Type

Un tipo de Canvas especializado para representar objetos Trace. Más...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Since: QtQuick.VirtualKeyboard 2.0
Inherits:

Canvas

Propiedades

Señales

Métodos

Descripción detallada

Este tipo ofrece funciones para representar objetos Trace en pantalla.

Para que la visualización de Trace esté disponible en el teclado, este tipo debe declararse como el componente « KeyboardStyle.traceCanvasDelegate ».

traceCanvasDelegate: TraceCanvas {
}

Los atributos de dibujo personalizados se pueden inicializar en la señal «Canvas.available». Por ejemplo:

onAvailableChanged: {
    if (!available)
        return;
    var ctx = getContext("2d")
    ctx.lineWidth = 8 * scaleHint
    ctx.lineCap = "round"
    ctx.strokeStyle = Qt.rgba(0xFF, 0xFF, 0xFF)
    ctx.fillStyle = ctx.strokeStyle
}

El tipo ofrece opciones integradas para la visualización de Trace. Actualmente están disponibles las siguientes opciones de visualización:

  • renderSmoothedLine Representa una línea suavizada con esquinas redondeadas (valor predeterminado)

La función de visualización se puede modificar mediante la propiedad « renderFunction ».

renderFunction: renderSmoothedLine

También se admite una función de representación personalizada. Considera el siguiente ejemplo:

renderFunction: renderCustomLine

function renderCustomLine() {
    getContext("2d")
    var points = trace.points()

    ...
}

Documentación de propiedades

autoDestroy : bool

Activa el modo de autodestrucción.

Si está activado, este elemento se destruirá cuando se destruya el objeto « trace ».

El valor por defecto es «false». En este caso, el lienzo se puede reutilizar después de que se active la señal « onRecycle ».

autoDestroyDelay : int

Especifica el retraso aproximado, en milisegundos, contado desde el inicio de la autodestrucción, antes de que el objeto sea destruido o reciclado.

Este retraso permite, por ejemplo, animar el elemento antes de su destrucción.

El valor por defecto es 0.

renderFunction : var

Esta propiedad define la función de representación.

El valor por defecto es renderSmoothedLine

trace : Trace

Proporciona acceso a un objeto « Trace ».

Documentación de Signal

[since 6.1] onRecycle(var traceCanvas)

Se emite cuando se recicla el traceCanvas.

Nota: El controlador correspondiente es onOnRecycle.

Esta señal se introdujo en Qt 6.1.

Documentación de métodos

[since 6.1] recycle()

Recicla el lienzo de traza borrando todos los dibujos y restableciendo las variables.

La función activa la señal « onRecycle » una vez finalizada (antes de la instrucción «return»).

La función devuelve «true» cuando el reciclaje se ha realizado correctamente.

Este método se introdujo en Qt 6.1.

[since 6.1] renderClear()

Borra la pantalla y restablece la visualización.

Este método se introdujo en Qt 6.1.

renderSmoothedLine()

Dibuja una línea suavizada con esquinas redondeadas.

Esta función es incremental y solo representa la nueva parte añadida al trazado.

Esta función no modifica ninguno de los atributos del lienzo (es decir, se pueden configurar en otro lugar).

© 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.