跟踪 QML 类型

跟踪是一个触摸输入数据的数据模型。更多...

导入语句	import QtQuick.VirtualKeyboard
自	QtQuick.VirtualKeyboard 2.0
实例化	QVirtualKeyboardTrace

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

属性

canceled : bool
channels : list
final : bool
opacity : qreal （自 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) （自 QtQuick.VirtualKeyboard.Styles 6.1 开始）

详细描述

跟踪提供了坐标数据和其他与单一笔迹关联的可选数据的数据模型。

跟踪对象的典型用例如下

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

使用 points() 函数检索坐标数据。

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

在添加点之前必须定义数据通道。下面列出了 TraceInputArea 支持的数据通道

"t" 收集每个数据点的计时。时间为自1970年1月1日起的毫秒数

例如，要配置对象以收集每个点的时序

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

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

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

Traverse对象的所有权属于其创建者，在正常情况下是输入法。这意味着对象是在 InputMethod.traceBegin() (QML) 方法中构建的。

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

属性文档

canceled : bool

此属性定义是否取消Trace。不应处理设置为true的 canceled 属性的跟踪的输入数据。

channels : list<strings>

跟踪中的附加数据通道列表。在添加数据之前必须初始化此属性。

final : bool

此属性定义跟踪是否可以接受更多数据。如果值为 true，则不接受更多数据。

opacity : qreal [since QtQuick.VirtualKeyboard 2.4]

此属性定义跟踪的不透明度。

较低的值会生成更透明的跟踪：0.0 完全透明，1.0 完全不透明。

此属性在添加新的跟踪时使旧的跟踪更加透明很有用。

此属性是在 QtQuick.VirtualKeyboard 2.4 中引入的。

traceId : int

此跟踪的唯一ID。

方法文档

int addPoint(point point)

将 point 添加到跟踪中。

该方法返回添加的点索引，或者在点无法添加时返回-1（即当 final 为 true）。

注意：返回的索引是必需的，以使用 setChannelData() 函数将其他数据与点关联。

var channelData(string channel, int pos, int count)

返回指定 channel 的数据。如果没有提供其他参数，则函数返回所有数据。

如果提供了 pos 参数，则函数返回从位置开始的数据。 count 参数限制返回的项数。

另请参阅：setChannelData().

var points(int pos, int count)

返回点列表。如果没有提供参数，则函数返回所有点。

如果提供了 pos 参数，则函数返回从位置开始的点。 count 参数限制返回的点的数量。

返回的列表包含 point 类型。

void setChannelData(int index, string channel, var data)

为给定数据channel中索引为index的点设置data。

如果该方法未为每个数据点调用，通道数据将以空值填充。但是，数据不能随意添加到任意索引，即它必须与点数据同步添加。

另见 channelData().

[since QtQuick.VirtualKeyboard.Styles 6.1] void startHideTimer(int delayMs)

在delayMs之后启动一个计时器，将透明度设置为零。如果在此期间再次调用，计时器将被重新启动。

使用这个函数，输入方法可以在销毁追踪对象之前将追踪从屏幕上隐藏，例如，以表示追踪已经被处理。

此方法自QtQuick.VirtualKeyboard.Styles 6.1版本引入。