Trace QML Type
Traceはタッチ入力データのデータモデルです。詳細...
| Import Statement: | import QtQuick.VirtualKeyboard |
| Since: | QtQuick.VirtualKeyboard 2.0 |
| In C++: | QVirtualKeyboardTrace |
プロパティ
- canceled : bool
- channels : list<strings>
- final : bool
- opacity : qreal
(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)
詳細説明
トレースは、1つのストロークに関連する座標データおよびその他のオプションデータのデータモデルを提供します。
トレースオブジェクトの典型的な使用例は次のとおりです：
- TraceInputArea または他の入力デバイスが () メソッドを呼び出してトレースイベントを開始します。InputEngine.traceBegin
- 現在の入力メソッドがイベントを受け入れると、トレース・オブジェクトが作成され、必要なデータ・チャンネル（もしあれば）が設定されます。
- TraceInputArea トレース・オブジェクトのデータを収集する。
- TraceInputArea InputEngine.traceEnd （）メソッドを呼び出してトレースを終了し、トレースオブジェクトを入力メソッドに渡す。
- input メソッドはデータを処理し、不要になったらオブジェクトを破棄する。
座標データは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) メソッド内でいつでも破棄することができます。
プロパティ Documentation
canceled : bool |
このプロパティは、トレースがキャンセルされるかどうかを定義します。canceled プロパティが true に設定されたトレースからは、入力データは処理されません。
channels : list<strings> |
トレース内の追加データチャネルのリスト。このプロパティは、データを追加する前に初期化する必要があります。
final : bool |
このプロパティは、トレースがより多くのデータを受け入れることができるかどうかを定義します。値がtrue の場合、それ以上のデータは受け付けられません。
opacity : qreal |
このプロパティは、Trace の不透明度を定義します。
値が小さいほど、より透明なトレースになります。0.0 は完全に透明で、1.0 は完全に不透明です。
このプロパティは、新しいトレースが追加されたときに、古いトレースをより透明にするのに便利です。
このプロパティは、QtQuick.VirtualKeyboard 2.4 で導入されました。
traceId : int |
このトレースのユニークID。
メソッドの説明
トレースにpoint を追加します。
このメソッドは、追加されたポイントのインデックスを返し、ポイントを追加できない場合 (つまり、final が true の場合) は -1 を返します。
注意: 返されたインデックスは、setChannelData() 関数を使用して追加データをポイントに関連付けるために必要です。
指定されたchannel からデータを返す。他のパラメータが与えられていない場合、関数はすべてのデータを返します。
pos パラメータが与えられると、関数はその位置から始まるデータを返します。count パラメータは、返される項目の数を制限します。
setChannelData()も参照してください 。
点のリストを返します。パラメータが与えられていない場合、関数はすべての点を返します。
pos パラメータが与えられると、関数はその位置から始まる点を返します。count パラメータは、返される点の数を制限する。
返されるリストには、point 型が含まれます。
与えられたデータchannel 内のindex の点に対してdata を設定します。
各データ・ポイントに対してこのメソッドを呼び出さない場合、チャネル・データは空の値でパディングされます。ただし、任意のインデックスでデータを追加することはできません。つまり、点データと同期して追加する必要があります。
channelData()も参照 。
|
delayMs の後に不透明度をゼロにするタイマーを開始する。delayMs 以内に再度呼び出されると、タイマーは再スタートします。
この関数を使用すると、トレースが処理されたことを示すために、トレースオブジェクトを破棄する前に、入力メソッドはトレースをスクリーンから隠すことができます。
このメソッドは、QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。
このドキュメントは、QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。 ここで提供されるドキュメントは、Free Software Foundationが発行したGNU Free Documentation License version 1.3の条項の下でライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
