Trace QML Type (Uncreatable)

Trace는 터치 입력 데이터를 위한 데이터 모델입니다. 더 보기...

참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스화할 수 없습니다.

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• canceled : bool
• channels : list<strings>
• final : bool
• opacity : real (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 6.1)

상세 설명

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

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

• 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");

Trace 객체는 생성자가 소유하며, 일반적인 경우 생성자는 입력 메서드입니다. 즉, 객체는 InputMethod.traceBegin() (QML) 메서드에서 생성됩니다.

정의에 따라, 트레이스 객체는 InputMethod.traceEnd() (QML) 메서드에서 가장 먼저 소멸될 수 있습니다.

속성 문서

canceled : bool

이 속성은 트레이스가 취소되었는지 여부를 정의합니다. ` canceled ` 속성이 true로 설정된 트레이스의 입력 데이터는 처리되어서는 안 됩니다.

channels : list<strings>

추적 정보에 포함된 추가 데이터 채널 목록입니다. 이 속성은 데이터를 추가하기 전에 초기화해야 합니다.

final : bool

이 속성은 트레이스가 더 많은 데이터를 수락할 수 있는지 여부를 정의합니다. 값이 ‘ true ’인 경우, 더 이상 데이터를 수락하지 않습니다.

opacity : real [since QtQuick.VirtualKeyboard 2.4]

이 속성은 트레이스의 불투명도를 정의합니다.

값이 낮을수록 트레이스가 더 투명해집니다. 0.0 는 완전히 투명하고, 1.0 는 완전히 불투명합니다.

이 속성은 새로운 트레이스가 추가됨에 따라 기존 트레이스의 투명도를 높이는 데 유용합니다.

이 속성은 QtQuick.VirtualKeyboard 2.4에서 도입되었습니다.

traceId : int

이 추적의 고유 ID입니다.

메서드 문서

int addPoint(point point)

트레이스(Trace)에 점( point )을 추가합니다.

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

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 6.1] void startHideTimer(int delayMs)

delayMs 가 지난 후 불투명도를 0으로 설정하도록 타이머를 시작합니다. delayMs 내에서 이 함수가 다시 호출되면 타이머가 다시 시작됩니다.

이 함수를 사용하면 입력 방식이 트레이스 객체를 소멸시키기 전에 화면에서 트레이스를 숨길 수 있습니다. 예를 들어, 트레이스 처리가 완료되었음을 나타내기 위함입니다.

이 메서드는 Qt 6.1에서 도입되었습니다.