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)

상세 설명

추적은 단일 스트로크와 관련된 좌표 데이터 및 기타 선택적 데이터에 대한 데이터 모델을 제공합니다.

추적 객체의 일반적인 사용 사례는 다음과 같습니다:

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) 메서드에서 가장 빨리 소멸될 수 있습니다.

속성 문서

canceled : bool

이 속성은 추적의 취소 여부를 정의합니다. canceled 속성이 true로 설정된 추적에서 입력 데이터를 처리해서는 안 됩니다.

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 를 추가합니다.

이 메서드는 추가된 포인트의 인덱스를 반환하고, 포인트를 추가할 수 없는 경우(즉, final 가 참인 경우) -1을 반환합니다.

참고: 반환된 인덱스는 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 이후 불투명도를 0으로 설정하는 타이머를 시작합니다. delayMs 내에서 다시 호출하면 타이머가 다시 시작됩니다.

이 함수를 사용하면 입력 메서드는 예를 들어 트레이스 객체를 소멸하기 전에 화면에서 트레이스가 처리되었음을 표시하기 위해 트레이스를 숨길 수 있습니다.

이 메서드는 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.