Back to Qt.io
Contact Us Blog Download Qt

InputEngine QML Type

사용자 입력을 입력 메소드에 매핑합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardInputEngine

속성

신호

방법

상세 설명

입력 엔진은 입력 이벤트를 입력 메소드로 라우팅하는 역할을 담당합니다. 실제 입력 로직은 입력 메서드에 의해 구현됩니다.

입력 엔진에는 활성 입력 메서드가 이벤트를 처리하지 않는 경우 기본 처리를 처리하는 기본 입력 메서드도 포함되어 있습니다.

속성 문서

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 중국어용 병음 입력 모드.
  • 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 일본어용 로마자 입력 모드.

inputModes : list<int> [read-only]

사용 가능한 입력 모드 목록은 입력 방법 및 로캘에 따라 달라집니다. 이 속성은 종속성 중 하나가 변경되면 업데이트됩니다.


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

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

사용 가능한 값입니다:

Constant설명
InputEngine.PatternRecognitionMode.None패턴 인식을 사용할 수 없습니다.
InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsolete - 대신 None 을 사용하세요.
InputEngine.PatternRecognitionMode.Handwriting필기 인식을 위한 패턴 인식 모드입니다.
InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsolete - 대신 Handwriting 을 사용하십시오.

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


previousKey : int [read-only]

이전에 누른 키.


wordCandidateListModel : SelectionListModel [read-only]

이 속성을 사용하여 단어 후보 목록의 목록 모델에 액세스합니다.


wordCandidateListVisibleHint : bool [read-only]

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


신호 문서

void activeKeyChanged(int key)

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

참고: 해당 핸들러는 onActiveKeyChanged 입니다.


void inputMethodChanged()

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

참고: 해당 핸들러는 onInputMethodChanged 입니다.


void inputMethodReset()

입력 방법을 재설정해야 할 때 발생합니다.

참고: 이 신호는 입력 방식이 활성화되면 QVirtualKeyboardAbstractInputMethod::reset() 및 InputMethod::reset()에 자동으로 연결됩니다.

참고: 해당 핸들러는 onInputMethodReset 입니다.


void inputMethodUpdate()

참고: 입력 방법이 활성화되면 이 신호는 QVirtualKeyboardAbstractInputMethod::update() 및 InputMethod::update()에 자동으로 연결됩니다.

참고: 해당 핸들러는 onInputMethodUpdate 입니다.


void inputModeChanged()

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

참고: 해당 핸들러는 onInputModeChanged 입니다.


void inputModesChanged()

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

참고: 해당 핸들러는 onInputModesChanged 입니다.


[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 사용

참고: 해당 핸들러는 onPatternRecognitionModesChanged 입니다.

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


void previousKeyChanged(int key)

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

참고: 해당 핸들러는 onPreviousKeyChanged 입니다.


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

가상 key 이 주어진 text 및 modifiers 과 함께 클릭되었음을 나타냅니다. 이 신호는 입력 메서드가 키 이벤트를 처리한 후에 발생합니다.

참고: 해당 핸들러는 onVirtualKeyClicked 입니다.


메서드 문서

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

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

추적은 traceId 에 의해 고유하게 식별됩니다. 입력 메서드가 이벤트를 수락하면 입력 엔진이 추적 객체에 ID를 할당합니다.

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

현재 입력 메서드가 이벤트를 수락하면 이 상호작용과 연관된 추적 객체를 반환합니다. 입력 메서드가 이벤트를 버리면 null 값을 반환합니다.

traceCaptureDeviceInfo 은 소스 디바이스에 대한 정보를 제공하고 traceScreenInfo 은 화면 컨텍스트에 대한 정보를 제공합니다.

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

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

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


bool traceEnd(Trace trace)

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

trace 객체는 이 함수를 호출한 후 언제든지 버릴 수 있습니다.

추적 상호작용이 수락된 경우(즉, 터치 이벤트가 다른 용도로 사용되지 않는 경우) 이 함수는 참을 반환합니다.


void virtualKeyCancel()

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


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

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


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

주어진 text 및 modifiers 과 함께 key 을 눌렀음을 나타내기 위해 키보드 레이어에서 호출됩니다.

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

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

이 입력 엔진에서 키를 수락한 경우 true 을 반환합니다.

virtualKeyCancel() 및 virtualKeyRelease()도 참조하세요 .


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

key 에서 키를 놓습니다. 이 메서드는 반복 타이머에 의해 이벤트가 생성되지 않은 경우 입력 메서드에 대한 키 이벤트를 발생시킵니다. text 및 modifiers 은 입력 메서드로 전달됩니다.

키가 입력 엔진에 의해 수락되면 true 을 반환합니다.


© 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.