Trace QML Type

Trace 是触摸输入数据的数据模型。更多

• 所有成员（包括继承成员）的列表

属性

• canceled : bool
• channels : list<strings>
• final : bool
• opacity : real (since QtQuick.VirtualKeyboard 2.4)
• traceId : int

方法

• int addPoint(point point)
• var channelData(string channel, int pos, int count)
• var points(int pos, int count)
• void setChannelData(int index, string channel, var data)
• void startHideTimer(int delayMs) (since QtQuick.VirtualKeyboard.Styles 6.1)

详细描述

轨迹为坐标数据和其他与单个描边相关的可选数据提供了数据模型。

跟踪对象的典型用例如下：

• TraceInputArea 或其他输入设备通过调用 () 方法启动跟踪事件。InputEngine.traceBegin
• 如果当前输入法接受该事件，则会创建跟踪对象并配置所需的数据通道（如果有）。
• TraceInputArea 为跟踪对象收集数据。
• TraceInputArea 调用 () 方法完成跟踪，并将跟踪对象传回输入法。InputEngine.traceEnd
• 输入方法处理数据，并在不再需要时丢弃对象。

坐标数据通过points() 函数获取。

除了基于坐标的数据外，还可以为每个数据点附加任意数据通道。

数据通道必须在添加点之前定义。TraceInputArea 支持的数据通道如下：

• "t" 为每个数据点收集时间。时间是自 1970/01/01 起的毫秒数：

例如，配置对象以收集每个点的时间：

QVirtualKeyboardTrace *trace = new QVirtualKeyboardTrace(this);
trace->setChannels(QStringList() << "t");

可以使用channelData() 函数访问收集到的数据：

QVariantList timeData = trace->channelData("t");

跟踪对象由其创建者拥有，创建者就是正常情况下的输入法。这意味着对象是在InputMethod.traceBegin() (QML) 方法中构建的。

根据定义，跟踪对象最早可在InputMethod.traceEnd() (QML) 方法中销毁。

属性文档

方法文档