內容

特性
公共函數
信號
靜態公共成員
詳細描述

QVirtualKeyboardTrace 類

跟蹤是用於觸摸輸入數據的數據模型。更多...

頭：	#include <QVirtualKeyboardTrace>
qmake:	QT += virtualkeyboard
Since:	QtQuick.VirtualKeyboard 2.0
實例化：	Trace
繼承：	QObject

特性

canceled : bool
channels : QStringList
final : bool

length : const int
opacity : qreal
traceId : int

1 特性繼承自 QObject

公共函數

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 )
int	traceId () const

31 公共函數繼承自 QObject

信號

void	canceledChanged (bool isCanceled )
void	channelsChanged ()
void	finalChanged (bool isFinal )
void	lengthChanged (int length )
void	opacityChanged (qreal opacity )
void	traceIdChanged (int traceId )

2 信號繼承自 QObject

靜態公共成員

const QMetaObject

staticMetaObject

9 靜態公共成員繼承自 QObject

額外繼承成員

1 公共槽繼承自 QObject
9 保護函數繼承自 QObject

詳細描述

跟蹤是用於觸摸輸入數據的數據模型。

跟蹤為坐標數據和單個筆畫關聯的其它可選數據，提供數據模型。

跟蹤對象的典型用例如下：

TraceInputArea (或其它輸入設備) 初啓跟蹤事件通過調用 InputEngine.traceBegin() 方法。
若當前輸入法接受事件，它會創建跟蹤對象並配置要求的數據通道 (若有的話)。
TraceInputArea 為追蹤對象收集數據。
TraceInputArea 調用 InputEngine.traceEnd() method to finish the trace and passing the trace object back to input method.
The input method processes the data and discards the object when it is no longer needed.

The coordinate data is retrieved using the points () 函數。

In addition to coordinate based data, it is possible to attach an arbitrary data channel for each data point.

The data channels must be defined before the points are added. The data channels supported by the TraceInputArea are listed below:

"t" Collects time for each data point. The time is the number of milliseconds since 1970/01/01:

例如，要配置對象以收集每點的時間：

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

可以訪問收集數據使用 channelData () 函數：

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

QVirtualKeyboardTrace objects are owned by their creator, which is the input method in normal case. This means the objects are constructed in the InputMethod.traceBegin() (QML) 方法。

根據定義，可以最早銷毀跟蹤對象在 InputMethod.traceEnd() (QML) 方法。

特性文檔編製

canceled : bool

定義是否 QVirtualKeyboardTrace 被取消。

不應處理其輸入數據，若跟蹤 canceled 特性被設為 true。

訪問函數：

bool	isCanceled () const
void	setCanceled (bool canceled )

通知程序信號：

void	canceledChanged (bool isCanceled )

channels : QStringList

QQTrace 中的數據通道列錶。

必須初始化此特性，在添加數據之前。

訪問函數：

QStringList	channels () const
void	setChannels (const QStringList & channels )

通知程序信號：

void	channelsChanged ()

final : bool

定義是否 QVirtualKeyboardTrace 可以接受更多數據。若值為 true ，不接受更多數據。

訪問函數：

bool	isFinal () const
void	setFinal (bool final )

通知程序信號：

void	finalChanged (bool isFinal )

length : const int

此特性保持點數在 QVirtualKeyboardTrace .

訪問函數：

int	length () const

通知程序信號：

void	lengthChanged (int length )

opacity : qreal

此特性定義如何不透明 QVirtualKeyboardTrace is.

較值産生更透明跟蹤： 0.0 完全透明，而 1.0 完全不透明。

此特性很有用，為使舊跟蹤更透明當添加新跟蹤時。

訪問函數：

qreal	opacity () const
void	setOpacity (qreal opacity )

通知程序信號：

void	opacityChanged (qreal opacity )

traceId : int

唯一 ID 為此 QVirtualKeyboardTrace .

訪問函數：

int	traceId () const
void	setTraceId (int id )

通知程序信號：

void	traceIdChanged (int traceId )

成員函數文檔編製

int QVirtualKeyboardTrace:: addPoint (const QPointF & point )

添加 point 到 QVirtualKeyboardTrace .

方法返迴點添加索引，或 -1 若點無法被添加 (即 final 為 True)。

注意： 返迴索引被要求關聯額外數據采用點使用 setChannelData () 方法。

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

QVariantList QVirtualKeyboardTrace:: channelData (const QString & channel , int pos = 0, int count = -1) const

返迴數據從指定 channel 。若未給定其它參數，方法返迴所有數據。

若 pos 參數有給定，方法返迴從位置起的數據。 count 參數限製返迴多少項。

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

另請參閱 setChannelData ().

QVariantList QVirtualKeyboardTrace:: points ( int pos = 0, int count = -1) const

返迴點的列錶。若不給定參數，方法返迴所有數據。

若 pos 參數有給定，方法返迴從位置起的點。 count 參數限製返迴多少點。

返迴列錶包含 QPointF 類型。

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

void QVirtualKeyboardTrace:: setChannelData (const QString & channel , int index , const QVariant & data )

集 data 為點在 index 按給定數據 channel .

若每數據點未調用此方法，將以空值填充通道數據。不管怎樣，無法在任意索引處添加數據 (即：它必須與點數據同步添加)。

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

另請參閱 channelData ().