InputEngine QML Type (Uncreatable)

사용자 입력을 입력 방식에 매핑합니다. 더 보기...

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

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

속성

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : list<int>
• patternRecognitionModes : list<int> (since QtQuick.VirtualKeyboard 2.0)
• previousKey : int
• wordCandidateListModel : SelectionListModel
• wordCandidateListVisibleHint : bool

신호

• void activeKeyChanged(int key)
• void inputMethodChanged()
• void inputMethodReset()
• void inputMethodUpdate()
• void inputModeChanged()
• void inputModesChanged()
• void patternRecognitionModesChanged() (since QtQuick.VirtualKeyboard 2.0)
• void previousKeyChanged(int key)
• void virtualKeyClicked(int key, string text, int modifiers)

방법

• Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo) (since QtQuick.VirtualKeyboard 2.0)
• bool traceEnd(Trace trace)
• void virtualKeyCancel()
• bool virtualKeyClick(int key, string text, int modifiers)
• bool virtualKeyPress(int key, string text, int modifiers, bool repeat)
• bool virtualKeyRelease(int key, string text, int modifiers)

상세 설명

입력 엔진은 입력 이벤트를 입력 방식에 전달하는 역할을 담당합니다. 실제 입력 로직은 입력 방식에서 구현됩니다.

또한 입력 엔진에는 기본 입력 방식이 포함되어 있으며, 활성 입력 방식이 이벤트를 처리하지 못할 경우 기본 처리를 담당합니다.

속성 설명서

activeKey : int [read-only]

현재 누르고 있는 키.

inputMethod : InputMethod

이 속성을 사용하여 활성 입력 방식을 설정하거나, 활성 입력 방식이 변경될 때 이를 감지할 수 있습니다.

inputMode : int

이 속성을 사용하여 현재 입력 모드를 가져오거나 설정할 수 있습니다. ` InputEngine::inputModes ` 속성은 현재 입력 방식 및 로캘에 대해 유효한 입력 모드 목록을 제공합니다.

사전 정의된 입력 모드는 다음과 같습니다.

• InputEngine.InputMode.Latin 라틴 문자 텍스트에 대한 기본 입력 모드입니다.
• InputEngine.InputMode.Numeric 숫자 입력만 허용됩니다.
• InputEngine.InputMode.Dialable 다이얼 입력만 허용됩니다.
• InputEngine.InputMode.Pinyin 중국어용 병음 입력 모드.
• InputEngine.InputMode.Cangjie 중국어용 창제(Cangjie) 입력 모드.
• InputEngine.InputMode.Zhuyin 중국어 주음 입력 모드.
• InputEngine.InputMode.Hangul 한국어의 한글 입력 모드.
• InputEngine.InputMode.Hiragana 일본어의 히라가나 입력 모드.
• InputEngine.InputMode.Katakana 일본어용 가타카나 입력 모드.
• InputEngine.InputMode.FullwidthLatin 동아시아 언어를 위한 전각 라틴 문자 입력 모드.
• InputEngine.InputMode.Greek 그리스어 입력 모드.
• InputEngine.InputMode.Cyrillic 키릴 문자 입력 모드.
• InputEngine.InputMode.Arabic 아랍어 입력 모드.
• InputEngine.InputMode.Hebrew 히브리어 입력 모드.
• InputEngine.InputMode.ChineseHandwriting 중국어 필기.
• InputEngine.InputMode.JapaneseHandwriting 일본어 필기.
• InputEngine.InputMode.KoreanHandwriting 한국어 필기.
• InputEngine.InputMode.Thai 태국어 입력 모드.
• InputEngine.InputMode.Stroke 중국어 필기 입력 모드.
• InputEngine.InputMode.Romaji 일본어 로마자 입력 모드.
• InputEngine.InputMode.HiraganaFlick 일본어용 플릭 입력 모드.

inputModes : list<int> [read-only]

사용 가능한 입력 모드 목록은 입력 방식과 지역 설정에 따라 달라집니다. 이 속성은 의존 항목 중 하나가 변경될 때 업데이트됩니다.

patternRecognitionModes : list<int> [read-only, since QtQuick.VirtualKeyboard 2.0]

사용 가능한 패턴 인식 모드 목록.

사용 가능한 값:

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

previousKey : int [read-only]

이전에 눌렀던 키.

wordCandidateListModel : SelectionListModel [read-only]

이 속성을 사용하여 단어 후보 목록의 목록 모델에 접근할 수 있습니다.

wordCandidateListVisibleHint : bool [read-only]

이 속성을 사용하여 단어 후보 목록을 UI에 표시할지 여부를 확인합니다.

Signal 문서

void activeKeyChanged(int key)

활성 상태인 key 이 변경되었음을 나타냅니다.

void inputMethodChanged()

입력 방식이 변경되었음을 나타냅니다.

void inputMethodReset()

입력 방식이 재설정되어야 할 때 발생합니다.

void inputMethodUpdate()

void inputModeChanged()

입력 모드가 변경되었음을 나타냅니다.

void inputModesChanged()

사용 가능한 입력 모드가 변경되었음을 나타냅니다.

[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

사용 가능한 패턴 인식 모드가 변경되었음을 나타냅니다.

사전 정의된 패턴 인식 모드는 다음과 같습니다:

• InputEngine.PatternRecognitionMode.None 패턴 인식 기능을 사용할 수 없습니다.
• InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete InputEngine .PatternRecognitionMode.None을 사용하십시오.
• InputEngine.PatternRecognitionMode.Handwriting 필기 인식용 패턴 인식 모드입니다.
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete InputEngine .PatternRecognitionMode.Handwriting을 사용하십시오.

이 신호는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

void previousKeyChanged(int key)

이전 key 가 변경되었음을 나타냅니다.

void virtualKeyClicked(int key, string text, int modifiers)

지정된 text 및 modifiers 값으로 가상 key 가 클릭되었음을 나타냅니다. 이 신호는 입력 방식이 키 이벤트를 처리한 후에 발생합니다.

메서드 문서

[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

입력 엔진과의 추적 상호작용을 시작합니다.

추적은 ` traceId`로 고유하게 식별됩니다. 입력 방식이 이벤트를 수락하면 입력 엔진이 해당 ID를 `Trace` 객체에 할당합니다.

patternRecognitionMode 는 패턴에 사용되는 인식 모드를 지정합니다.

현재 입력 방식이 이벤트를 수락하면 이 상호작용과 연관된 Trace 객체를 반환합니다. 입력 방식이 이벤트를 무시하면 null 값을 반환합니다.

traceCaptureDeviceInfo 은 소스 장치에 대한 정보를 제공하며, traceScreenInfo 는 화면 컨텍스트에 대한 정보를 제공합니다.

정의에 따라 Trace 객체는 traceEnd() 메서드가 호출될 때까지 유효합니다.

InputEngine.traceEnd() 메서드를 호출하면 추적 상호작용이 종료됩니다.

이 메서드는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

bool traceEnd(Trace trace)

입력 엔진과의 추적 상호작용을 종료합니다.

이 함수를 호출한 후에는 언제든지 ` trace ` 객체를 해제할 수 있습니다.

추적 상호작용이 수락된 경우(즉, 터치 이벤트를 다른 용도로 사용해서는 안 되는 경우), 이 함수는 true를 반환합니다.

void virtualKeyCancel()

키 이벤트를 발생시키지 않고 활성 키 상태를 원래대로 되돌립니다. 이 메서드는 사용자가 현재 키를 해제했을 때 키 상태를 복원해야 할 때 유용합니다.

bool virtualKeyClick(int key, string text, int modifiers)

지정된 ` key`, ` text ` 및 ` modifiers`에 대해 키 클릭 이벤트를 발생시킵니다. 입력 엔진에서 키 이벤트를 수락한 경우 ` true `를 반환합니다.

bool virtualKeyPress(int key, string text, int modifiers, bool repeat)

키보드 레이어에서 key 키가 눌렸음을 알리기 위해 호출되며, 주어진 text 및 modifiers 값을 갖습니다.

key 는 활성 키(누름 키)로 설정됩니다. 실제 키 이벤트는 virtualKeyRelease() 메서드를 통해 키가 놓일 때 트리거됩니다. virtualKeyCancel()를 호출하여 키 누름 이벤트를 취소할 수 있습니다.

repeat 가 true 인 경우, 키 누름은 키 반복 타이머도 시작합니다.

키가 이 입력 엔진에 의해 수락된 경우 true 를 반환합니다.

virtualKeyCancel() 및 virtualKeyRelease()도 참조하십시오 .

bool virtualKeyRelease(int key, string text, int modifiers)

key 에서 키를 해제합니다. 이 메서드는 이벤트가 반복 타이머에 의해 생성된 것이 아닌 경우, 입력 방식에 대한 키 이벤트를 발생시킵니다. text 및 modifiers 는 입력 방식으로 전달됩니다.

키가 입력 엔진에 의해 수락된 경우 true 을 반환합니다.