TraceCanvas QML 类型

一个专用的 Canvas 类型，用于渲染 Trace 对象。更多...

导入声明	import QtQuick.VirtualKeyboard.Styles
从	QtQuick.VirtualKeyboard 2.0
继承	Canvas

所有成员的列表，包括继承的成员

属性

autoDestroy : bool
autoDestroyDelay : int
renderFunction : var
trace : Trace

信号

onRecycle(var traceCanvas) (自 QtQuick.VirtualKeyboard.Styles 6.1)

方法

recycle() (自 QtQuick.VirtualKeyboard.Styles 6.1)
renderClear() (自 QtQuick.VirtualKeyboard.Styles 6.1)
renderSmoothedLine()

详细描述

此类型提供了在屏幕上渲染 Trace 对象的能力。

要使 Trace 渲染在键盘上可用，必须将此类型声明为 KeyboardStyle.traceCanvasDelegate 组件。

traceCanvasDelegate: TraceCanvas {
}

可以在 Canvas.available 信号中初始化自定义绘图属性。例如

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
}

此类型提供了内置的 Trace 渲染选项。当前以下渲染选项可用

renderSmoothedLine 渲染带有圆角的平滑线条（默认）

可以通过 renderFunction 属性更改渲染函数。

renderFunction: renderSmoothedLine

也支持自定义渲染函数。以下是一个示例

renderFunction: renderCustomLine

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

    ...
}

属性文档

autoDestroy : bool

启用自动销毁模式。

如果启用，当 trace 对象被销毁时，此项目也将被销毁。

默认值是 false。在这种情况下，在 onRecycle 信号被触发后，画布可以重复使用。

autoDestroyDelay : int

指定从自动销毁开始计算的以毫秒为单位的约延迟时间，在此之后对象将被销毁或回收。

此延迟使得在销毁前可以对这个项目进行动画处理。

默认值是 0。

renderFunction : 变量

此属性定义渲染函数。

默认值是 renderSmoothedLine

trace : 跟踪

提供对跟踪对象的访问。

信号文档

[自 QtQuick.VirtualKeyboard.Styles 6.1 起使用] onRecycle(变量 traceCanvas)

当 traceCanvas 被回收时发出。

注意：对应的处理程序是 onOnRecycle.

此信号在 QtQuick.VirtualKeyboard.Styles 6.1 中引入。

方法文档

[自 QtQuick.VirtualKeyboard.Styles 6.1 起使用] recycle()

通过清除所有绘图并重置变量来回收跟踪画布。

该函数在完成（返回之前）触发 onRecycle 信号。

当回收成功时，该函数返回 true。

此方法在 QtQuick.VirtualKeyboard.Styles 6.1 中引入。

[自 QtQuick.VirtualKeyboard.Styles 6.1 起使用] renderClear()

清除屏幕并重置渲染。

此方法在 QtQuick.VirtualKeyboard.Styles 6.1 中引入。

renderSmoothedLine()

以圆角绘制光滑线条。

此函数是增量式，仅渲染添加到跟踪中的新部分。

此函数不改变画布的任何属性（即可以在其他地方设置它们。）