이 페이지에서

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::Latin0라틴 문자 텍스트의 기본 입력 모드입니다.
QVirtualKeyboardInputEngine::InputMode::Numeric1숫자 입력만 허용됩니다.
QVirtualKeyboardInputEngine::InputMode::Dialable2다이얼 입력만 허용됩니다.
QVirtualKeyboardInputEngine::InputMode::Pinyin3중국어용 병음 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Cangjie4중국어용 창제(Cangjie) 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Zhuyin5중국어 주음 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Hangul6한국어의 한글 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Hiragana7일본어의 히라가나 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Katakana8일본어용 가타카나 입력 모드.
QVirtualKeyboardInputEngine::InputMode::FullwidthLatin9동아시아 언어를 위한 풀와이드 라틴 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Greek10그리스어 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Cyrillic11키릴 문자 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Arabic12아랍어 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Hebrew13히브리어 입력 모드.
QVirtualKeyboardInputEngine::InputMode::ChineseHandwriting14중국어 필기 입력 모드.
QVirtualKeyboardInputEngine::InputMode::JapaneseHandwriting15일본어 필기 입력 모드.
QVirtualKeyboardInputEngine::InputMode::KoreanHandwriting16한국어 필기 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Thai17태국어 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Stroke18중국어 필기 입력 모드.
QVirtualKeyboardInputEngine::InputMode::Romaji19일본어 로마자 입력 모드.
QVirtualKeyboardInputEngine::InputMode::HiraganaFlick20일본어용 플릭 입력 모드.

enum class QVirtualKeyboardInputEngine::PatternRecognitionMode

이 열거형은 입력 방식의 입력 모드를 지정합니다.

상수값설명
QVirtualKeyboardInputEngine::PatternRecognitionMode::None0패턴 인식 기능을 사용할 수 없습니다.
QVirtualKeyboardInputEngine::PatternRecognitionMode::PatternRecognitionDisabledNoneobsolete PatternRecognitionMode::None을 사용하십시오.
QVirtualKeyboardInputEngine::PatternRecognitionMode::Handwriting1필기 인식용 패턴 인식 모드입니다.
QVirtualKeyboardInputEngine::PatternRecognitionMode::HandwritingRecoginitionHandwritingobsolete PatternRecognitionMode::Handwriting을 사용하십시오.

enum class QVirtualKeyboardInputEngine::ReselectFlag
flags QVirtualKeyboardInputEngine::ReselectFlags

이 열거형은 단어 재선택에 대한 규칙을 지정합니다.

상수값설명
QVirtualKeyboardInputEngine::ReselectFlag::WordBeforeCursor0x1커서 앞의 단어를 활성화합니다. 이 플래그만 단독으로 사용될 경우, 단어는 커서 위치에서 정확히 끝나야 합니다.
QVirtualKeyboardInputEngine::ReselectFlag::WordAfterCursor0x2커서 뒤의 단어를 활성화합니다. 이 플래그만 단독으로 사용할 경우, 단어는 커서 위치에서 정확히 시작해야 합니다.
QVirtualKeyboardInputEngine::ReselectFlag::WordAtCursorWordBeforeCursor | WordAfterCursor커서 위치에 있는 단어를 활성화합니다. 이 플래그는 위의 플래그들을 조합한 것이나, 단어가 커서 위치에서 시작하거나 끝날 수는 없다는 점이 다릅니다.

ReselectFlags 유형은 QFlags<ReselectFlag>에 대한 typedef입니다. 이 유형은 ReselectFlag 값들의 OR 조합을 저장합니다.

enum class QVirtualKeyboardInputEngine::TextCase

이 열거형은 입력 방식의 문자 대소문자 구분을 지정합니다.

상수값설명
QVirtualKeyboardInputEngine::TextCase::Lower0소문자 텍스트.
QVirtualKeyboardInputEngine::TextCase::Upper1대문자 텍스트.

속성 설명

[read-only] activeKey : Qt::Key

이 속성은 활성 키를 저장합니다.

현재 눌려 있는 키입니다.

액세스 함수:

Qt::Key activeKey() const

알림 신호:

void activeKeyChanged(Qt::Key key)

inputMethod : QVirtualKeyboardAbstractInputMethod*

이 속성은 현재 활성화된 입력 방식을 저장합니다.

이 속성을 사용하여 입력 방식을 활성 상태로 설정하거나, 활성 입력 방식이 변경되는 시점을 모니터링할 수 있습니다.

액세스 함수:

QVirtualKeyboardAbstractInputMethod *inputMethod() const
void setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)

알림 신호:

inputMode : InputMode

이 속성은 현재 입력 모드를 저장합니다.

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

액세스 함수:

QVirtualKeyboardInputEngine::InputMode inputMode() const
void setInputMode(QVirtualKeyboardInputEngine::InputMode inputMode)

알림 신호:

[read-only] inputModes : QList<int>

이 속성은 활성 입력 방식에 대해 사용 가능한 입력 모드를 저장합니다.

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

액세스 함수:

QList<int> inputModes() const

알림 신호:

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