QVirtualKeyboardInputEngine Class
InputEngine 클래스는 C++ 및 QML 통합을 지원하는 입력 엔진을 제공합니다. 더 보기...
| 헤더: | #include <QVirtualKeyboardInputEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| QML에서: | InputEngine |
| 상속: | QObject |
공개 타입
| enum class | InputMode { Latin, Numeric, Dialable, Pinyin, Cangjie, …, HiraganaFlick } |
| enum class | PatternRecognitionMode { None, PatternRecognitionDisabled, Handwriting, HandwritingRecoginition } |
| enum class | ReselectFlag { WordBeforeCursor, WordAfterCursor, WordAtCursor } |
| flags | ReselectFlags |
| enum class | TextCase { Lower, Upper } |
속성
|
|
공개 함수
| Qt::Key | activeKey() const |
| QVirtualKeyboardInputContext * | inputContext() const |
| QVirtualKeyboardAbstractInputMethod * | inputMethod() const |
| QVirtualKeyboardInputEngine::InputMode | inputMode() const |
| QList<int> | inputModes() const |
| QList<int> | patternRecognitionModes() const |
| Qt::Key | previousKey() const |
(since QtQuick.VirtualKeyboard 2.0) bool | reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags) |
| void | setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod) |
| void | setInputMode(QVirtualKeyboardInputEngine::InputMode inputMode) |
(since QtQuick.VirtualKeyboard 2.0) QVirtualKeyboardTrace * | traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo) |
| bool | traceEnd(QVirtualKeyboardTrace *trace) |
| void | virtualKeyCancel() |
| bool | virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) |
| bool | virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat) |
| bool | virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) |
| QVirtualKeyboardSelectionListModel * | wordCandidateListModel() const |
| bool | wordCandidateListVisibleHint() const |
신호
| void | activeKeyChanged(Qt::Key key) |
| void | inputMethodChanged() |
| void | inputMethodReset() |
| void | inputMethodUpdate() |
| void | inputModeChanged() |
| void | inputModesChanged() |
(since QtQuick.VirtualKeyboard 2.0) void | patternRecognitionModesChanged() |
| void | previousKeyChanged(Qt::Key key) |
| void | virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat) |
| void | wordCandidateListModelChanged() |
| void | wordCandidateListVisibleHintChanged() |
상세 설명
입력 엔진은 입력 이벤트를 입력 방식에 전달하는 역할을 담당합니다. 실제 입력 로직은 입력 방식에 의해 구현됩니다.
입력 엔진에는 기본 입력 방식도 포함되어 있으며, 활성 입력 방식이 이벤트를 처리하지 못할 경우 기본 처리를 담당합니다.
멤버 유형 설명서
enum class QVirtualKeyboardInputEngine::InputMode
이 열거형은 입력 방식의 입력 모드를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardInputEngine::InputMode::Latin | 0 | 라틴 문자 텍스트의 기본 입력 모드입니다. |
QVirtualKeyboardInputEngine::InputMode::Numeric | 1 | 숫자 입력만 허용됩니다. |
QVirtualKeyboardInputEngine::InputMode::Dialable | 2 | 다이얼 입력만 허용됩니다. |
QVirtualKeyboardInputEngine::InputMode::Pinyin | 3 | 중국어용 병음 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Cangjie | 4 | 중국어용 창제(Cangjie) 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Zhuyin | 5 | 중국어 주음 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Hangul | 6 | 한국어의 한글 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Hiragana | 7 | 일본어의 히라가나 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Katakana | 8 | 일본어용 가타카나 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::FullwidthLatin | 9 | 동아시아 언어를 위한 풀와이드 라틴 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Greek | 10 | 그리스어 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Cyrillic | 11 | 키릴 문자 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Arabic | 12 | 아랍어 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Hebrew | 13 | 히브리어 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::ChineseHandwriting | 14 | 중국어 필기 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::JapaneseHandwriting | 15 | 일본어 필기 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::KoreanHandwriting | 16 | 한국어 필기 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Thai | 17 | 태국어 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Stroke | 18 | 중국어 필기 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::Romaji | 19 | 일본어 로마자 입력 모드. |
QVirtualKeyboardInputEngine::InputMode::HiraganaFlick | 20 | 일본어용 플릭 입력 모드. |
enum class QVirtualKeyboardInputEngine::PatternRecognitionMode
이 열거형은 입력 방식의 입력 모드를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardInputEngine::PatternRecognitionMode::None | 0 | 패턴 인식 기능을 사용할 수 없습니다. |
QVirtualKeyboardInputEngine::PatternRecognitionMode::PatternRecognitionDisabled | None | obsolete PatternRecognitionMode::None을 사용하십시오. |
QVirtualKeyboardInputEngine::PatternRecognitionMode::Handwriting | 1 | 필기 인식용 패턴 인식 모드입니다. |
QVirtualKeyboardInputEngine::PatternRecognitionMode::HandwritingRecoginition | Handwriting | obsolete PatternRecognitionMode::Handwriting을 사용하십시오. |
enum class QVirtualKeyboardInputEngine::ReselectFlag
flags QVirtualKeyboardInputEngine::ReselectFlags
이 열거형은 단어 재선택에 대한 규칙을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardInputEngine::ReselectFlag::WordBeforeCursor | 0x1 | 커서 앞의 단어를 활성화합니다. 이 플래그만 단독으로 사용될 경우, 단어는 커서 위치에서 정확히 끝나야 합니다. |
QVirtualKeyboardInputEngine::ReselectFlag::WordAfterCursor | 0x2 | 커서 뒤의 단어를 활성화합니다. 이 플래그만 단독으로 사용할 경우, 단어는 커서 위치에서 정확히 시작해야 합니다. |
QVirtualKeyboardInputEngine::ReselectFlag::WordAtCursor | WordBeforeCursor | WordAfterCursor | 커서 위치에 있는 단어를 활성화합니다. 이 플래그는 위의 플래그들을 조합한 것이나, 단어가 커서 위치에서 시작하거나 끝날 수는 없다는 점이 다릅니다. |
ReselectFlags 유형은 QFlags<ReselectFlag>에 대한 typedef입니다. 이 유형은 ReselectFlag 값들의 OR 조합을 저장합니다.
enum class QVirtualKeyboardInputEngine::TextCase
이 열거형은 입력 방식의 문자 대소문자 구분을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardInputEngine::TextCase::Lower | 0 | 소문자 텍스트. |
QVirtualKeyboardInputEngine::TextCase::Upper | 1 | 대문자 텍스트. |
속성 설명
[read-only] activeKey : Qt::Key
이 속성은 활성 키를 저장합니다.
현재 눌려 있는 키입니다.
액세스 함수:
| Qt::Key | activeKey() const |
알림 신호:
| void | activeKeyChanged(Qt::Key key) |
inputMethod : QVirtualKeyboardAbstractInputMethod*
이 속성은 현재 활성화된 입력 방식을 저장합니다.
이 속성을 사용하여 입력 방식을 활성 상태로 설정하거나, 활성 입력 방식이 변경되는 시점을 모니터링할 수 있습니다.
액세스 함수:
| QVirtualKeyboardAbstractInputMethod * | inputMethod() const |
| void | setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod) |
알림 신호:
| void | inputMethodChanged() |
inputMode : InputMode
이 속성은 현재 입력 모드를 저장합니다.
이 속성을 사용하여 현재 입력 모드를 조회하거나 설정할 수 있습니다. ` InputEngine::inputModes `는 현재 입력 방식 및 로캘에 대해 유효한 입력 모드 목록을 제공합니다.
액세스 함수:
| QVirtualKeyboardInputEngine::InputMode | inputMode() const |
| void | setInputMode(QVirtualKeyboardInputEngine::InputMode inputMode) |
알림 신호:
| void | inputModeChanged() |
[read-only] inputModes : QList<int>
이 속성은 활성 입력 방식에 대해 사용 가능한 입력 모드를 저장합니다.
사용 가능한 입력 모드 목록은 입력 방식과 로케일에 따라 달라집니다. 이 속성은 의존 항목 중 하나가 변경될 때 업데이트됩니다.
액세스 함수:
| QList<int> | inputModes() const |
알림 신호:
| void | inputModesChanged() |
[read-only, since QtQuick.VirtualKeyboard 2.0] patternRecognitionModes : QList<int>
이 속성은 사용 가능한 패턴 인식 모드 목록을 포함합니다.
사용 가능한 패턴 인식 모드 목록.
이 열거형은 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.
액세스 함수:
| QList<int> | patternRecognitionModes() const |
알림 신호:
[read-only] previousKey : Qt::Key
이 속성은 이전에 활성 상태였던 키를 저장합니다.
이전에 눌렸던 키입니다.
액세스 함수:
| Qt::Key | previousKey() const |
알림 신호:
| void | previousKeyChanged(Qt::Key key) |
[read-only] wordCandidateListModel : QVirtualKeyboardSelectionListModel*
단어 후보 목록에 대한 목록 모델.
이 속성을 사용하여 단어 후보 목록에 대한 목록 모델에 접근할 수 있습니다.
액세스 함수:
| QVirtualKeyboardSelectionListModel * | wordCandidateListModel() const |
알림 신호:
| void | wordCandidateListModelChanged() |
[read-only] wordCandidateListVisibleHint : bool
단어 후보 목록에 대한 시각적 힌트.
이 속성을 사용하여 단어 후보 목록을 UI에 표시할지 여부를 확인합니다.
액세스 함수:
| bool | wordCandidateListVisibleHint() const |
알림 신호:
| void | wordCandidateListVisibleHintChanged() |
멤버 함수 설명서
Qt::Key QVirtualKeyboardInputEngine::activeKey() const
현재 활성화된 키를 반환하거나, 활성화된 키가 없는 경우 ` Qt::Key_unknown `를 반환합니다.
참고: activeKey 속성에 대한게터 함수입니다.
[signal] void QVirtualKeyboardInputEngine::activeKeyChanged(Qt::Key key)
활성 상태인 key 가 변경되었음을 나타냅니다.
참고: 속성 ` activeKey`에 대한알림 신호입니다.
QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const
입력 엔진과 연결된 ` InputContext ` 인스턴스를 반환합니다.
QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const
현재 활성화된 입력 방식을 반환합니다.
참고: inputMethod 속성에 대한게터 함수입니다.
setInputMethod()도 참조하십시오 .
[signal] void QVirtualKeyboardInputEngine::inputMethodChanged()
입력 방식이 변경되었음을 나타냅니다.
참고: 속성 ` inputMethod`에 대한알림 신호입니다.
[signal] void QVirtualKeyboardInputEngine::inputMethodReset()
입력 방식이 재설정되어야 할 때 발생합니다.
참고: 이 신호는 입력 방식이 활성화되면 QVirtualKeyboardAbstractInputMethod::reset() 및 InputMethod::reset()에 자동으로 연결됩니다.
[signal] void QVirtualKeyboardInputEngine::inputMethodUpdate()
참고: 이 신호는 입력 방식이 활성화되면 QVirtualKeyboardAbstractInputMethod::update() 및 InputMethod::update()에 자동으로 연결됩니다.
[signal] void QVirtualKeyboardInputEngine::inputModeChanged()
입력 모드가 변경되었음을 나타냅니다.
참고: 속성 inputMode 에 대한알림 신호입니다.
QList<int> QVirtualKeyboardInputEngine::inputModes() const
사용 가능한 입력 모드 목록을 반환합니다.
참고: inputModes 속성에 대한게터 함수입니다.
[signal] void QVirtualKeyboardInputEngine::inputModesChanged()
사용 가능한 입력 모드가 변경되었음을 나타냅니다.
참고: 속성 inputModes 에 대한알림 신호입니다.
QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const
지원되는 패턴 인식 모드 목록을 반환합니다.
참고: patternRecognitionModes 속성에 대한게터 함수입니다.
[signal, since QtQuick.VirtualKeyboard 2.0] void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()
사용 가능한 패턴 인식 모드가 변경되었음을 나타냅니다.
참고: 속성 ` patternRecognitionModes`에 대한알림 신호입니다.
이 기능은 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.
Qt::Key QVirtualKeyboardInputEngine::previousKey() const
이전에 활성 상태였던 키를 반환하며, 활성 상태였던 키가 없는 경우에는 ` Qt::Key_unknown `를 반환합니다.
참고: previousKey 속성에 대한게터 함수입니다.
[signal] void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)
이전 key 가 변경되었음을 나타냅니다.
참고: 속성 previousKey 에 대한알림 신호입니다.
[invokable, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardInputEngine::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)
이 함수는 cursorPosition 위치에 있는 단어를 다시 선택하려고 시도합니다. reselectFlags 는 커서 위치와 관련하여 단어를 선택하는 방법에 대한 규칙을 정의합니다.
단어가 성공적으로 재선택된 경우, 이 함수는 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.
void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)
inputMethod 를 활성 입력 방식으로 설정합니다.
참고: inputMethod 속성에 대한세터 함수입니다.
inputMethod()도 참조하십시오 .
[invokable, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardInputEngine::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)
입력 엔진과의 추적 상호 작용을 시작합니다.
이 추적은 ` traceId`로 고유하게 식별됩니다. 입력 방식이 이벤트를 수락하면 입력 엔진은 해당 ID를 ` QVirtualKeyboardTrace ` 객체에 할당합니다.
patternRecognitionMode 는 패턴에 사용되는 인식 모드를 지정합니다.
현재 입력 방식이 이벤트를 수락하면, 이 상호작용과 연관된 QVirtualKeyboardTrace 객체를 반환합니다. 입력 방식이 이벤트를 무시하면 NULL 값을 반환합니다.
traceCaptureDeviceInfo 는 소스 장치에 대한 정보를 제공하며, traceScreenInfo 는 화면 컨텍스트에 대한 정보를 제공합니다.
정의에 따라, QVirtualKeyboardTrace 객체는 traceEnd() 메서드가 호출될 때까지 유효한 상태를 유지합니다.
traceEnd() 메서드를 호출하면 추적 상호작용이 종료됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.
[invokable] bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)
입력 엔진과의 추적 상호작용을 종료합니다.
이 함수를 호출한 후에는 언제든지 ` trace ` 객체를 해제할 수 있습니다.
추적 상호작용이 수락된 경우(즉, 터치 이벤트를 다른 용도로 사용해서는 안 되는 경우) 이 함수는 true를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QVirtualKeyboardInputEngine::virtualKeyCancel()
키 이벤트를 발생시키지 않고 활성 키 상태를 원래대로 되돌립니다. 이 메서드는 사용자가 현재 키를 해제했을 때 키 상태를 복원해야 할 때 유용합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
지정된 key, text 및 modifiers 에 대해 키 클릭 이벤트를 발생시킵니다. 키 이벤트가 입력 엔진에 의해 수락된 경우 true 를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[signal] void QVirtualKeyboardInputEngine::virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat)
주어진 text 및 modifiers 값으로 가상 키 key 가 클릭되었음을 나타냅니다. isAutoRepeat 는 키가 눌려 있는 동안 이벤트가 자동으로 반복되는지 여부를 나타냅니다. 이 신호는 입력 방식이 키 이벤트를 처리한 후에 발생합니다.
[invokable] bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat)
키보드 레이어에서 key 키가 눌렸음을 알리기 위해 호출되며, 주어진 text 및 modifiers 값을 전달받습니다.
key 는 활성 키(누름 상태 키)로 설정됩니다. 실제 키 이벤트는 virtualKeyRelease() 메서드를 통해 키가 놓일 때 트리거됩니다. virtualKeyCancel()를 호출하여 키 누름 이벤트를 취소할 수 있습니다.
repeat 가 true 인 경우, 키 누름 시 키 반복 타이머도 시작됩니다.
키가 이 입력 엔진에 의해 수락된 경우 true 를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
virtualKeyCancel() 및 virtualKeyRelease()도 참조하십시오 .
[invokable] bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
key 에서 키를 해제합니다. 이 메서드는 이벤트가 반복 타이머에 의해 생성된 것이 아닌 경우, 입력 방식에 대한 키 이벤트를 발생시킵니다. text 및 modifiers 가 입력 방식에 전달됩니다.
키가 입력 엔진에 의해 수락된 경우 true 를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
© 2026 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.