QVirtualKeyboardTrace Class
Traceはタッチ入力データのデータモデルです。詳細...
| ヘッダー | #include <QVirtualKeyboardTrace> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake： | QT += virtualkeyboard |
| 以来： | QtQuick.VirtualKeyboard 2.0 |
| QML で： | Trace |
| 継承： | 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) |
(since QtQuick.VirtualKeyboard.Styles 6.1) void | startHideTimer(int delayMs) |
| int | traceId() const |
シグナル
| void | canceledChanged(bool isCanceled) |
| void | channelsChanged() |
| void | finalChanged(bool isFinal) |
| void | lengthChanged(int length) |
| void | opacityChanged(qreal opacity) |
| void | traceIdChanged(int traceId) |
詳細説明
Traceは、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");
QVirtualKeyboardTrace オブジェクトはその作成者（通常の場合は入力メソッド）によって所有されます。つまり、オブジェクトは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) |
[read-only] length : const int
この特性は、QVirtualKeyboardTrace に含まれる点の数を保持する。
アクセス関数：
| int | length() const |
通知シグナル：
| void | lengthChanged(int length) |
opacity : qreal
このプロパティは、QVirtualKeyboardTrace の不透明度を定義する。
値が低いほど、トレースはより透明になります。0.0 は完全に透明で、1.0 は完全に不透明です。
このプロパティは、新しいトレースが追加されたときに、古いトレースをより透明にするのに便利です。
アクセス関数：
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
通知シグナル：
| void | opacityChanged(qreal opacity) |
traceId : int
このQVirtualKeyboardTrace のユニークID。
アクセス機能：
| int | traceId() const |
| void | setTraceId(int id) |
通知シグナル
| void | traceIdChanged(int traceId) |
メンバー関数ドキュメント
[invokable] int QVirtualKeyboardTrace::addPoint(const QPointF &point)
QVirtualKeyboardTrace にpoint を追加する。
このメソッドは、追加された点のインデックスを返し、点を追加できない場合 (つまり、final が true の場合) は -1 を返します。
注意： 返されたインデックスは、setChannelData （）メソッドを使用して、追加データを点に関連付けるために必要です。
注意 ：この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QVariantList QVirtualKeyboardTrace::channelData(const QString &channel, int pos = 0, int count = -1) const
指定されたchannel からデータを返す。他のパラメータが与えられない場合、メソッドはすべてのデータを返します。
pos パラメータを指定すると、メソッドはその位置から始まるデータを返します。count パラメータは、返される項目の数を制限します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
setChannelData()も参照してください 。
[invokable] QVariantList QVirtualKeyboardTrace::points(int pos = 0, int count = -1) const
点のリストを返す。パラメータが与えられていない場合、メソッドはすべてのデータを返します。
pos パラメータが与えられると、メソッドはその位置から始まる点を返します。count パラメータは、返される点の数を制限します。
返されるリストには、QPointF 型が含まれます。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QVirtualKeyboardTrace::setChannelData(const QString &channel, int index, const QVariant &data)
与えられたデータchannel のindex のポイントにdata を設定する。
各データ・ポイントに対してこのメソッドを呼び出さない場合、チャンネル・データは空の値でパディングされる。ただし、任意のインデックスでデータを追加することはできません。つまり、ポイント・データと同期して追加する必要があります。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
channelData()も参照して ください。
[invokable, since QtQuick.VirtualKeyboard.Styles 6.1] void QVirtualKeyboardTrace::startHideTimer(int delayMs)
delayMs の後に不透明度をゼロにするタイマーを開始する。delayMs 以内に再度呼び出されると、タイマーは再スタートする。
この関数を使うことで、例えばトレースが処理されたことを示すために、トレースオブジェクトを破棄する前に、入力メソッドはスクリーンからトレースを隠すことができます。
注意： この関数は、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
