QVirtualKeyboardInputEngine Class
InputEngine 클래스는 C++ 및 QML 통합을 지원하는 입력 엔진을 제공합니다. 더 보기...
Header: | #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, …, Romaji } |
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
이 열거형은 입력 방법의 입력 모드를 지정합니다.
Constant | 값 | 설명 |
---|---|---|
QVirtualKeyboardInputEngine::InputMode::Latin | 0 | 라틴 텍스트의 기본 입력 모드입니다. |
QVirtualKeyboardInputEngine::InputMode::Numeric | 1 | 숫자 입력만 허용됩니다. |
QVirtualKeyboardInputEngine::InputMode::Dialable | 2 | 다이얼 가능한 입력만 허용됩니다. |
QVirtualKeyboardInputEngine::InputMode::Pinyin | 3 | 중국어 병음 입력 모드입니다. |
QVirtualKeyboardInputEngine::InputMode::Cangjie | 4 | 중국어용 병음 입력 모드입니다. |
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 | 일본어 로마지 입력 모드. |
enum class QVirtualKeyboardInputEngine::PatternRecognitionMode
이 열거형은 입력 방법의 입력 모드를 지정합니다.
Constant | 값 | 설명 |
---|---|---|
QVirtualKeyboardInputEngine::PatternRecognitionMode::None | 0 | 패턴 인식을 사용할 수 없습니다. |
QVirtualKeyboardInputEngine::PatternRecognitionMode::PatternRecognitionDisabled | None | obsolete 패턴 인식 모드::없음 사용 |
QVirtualKeyboardInputEngine::PatternRecognitionMode::Handwriting | 1 | 필기 인식을 위한 패턴 인식 모드입니다. |
QVirtualKeyboardInputEngine::PatternRecognitionMode::HandwritingRecoginition | Handwriting | obsolete 패턴 인식 모드::손글씨 사용 |
열거형 클래스 QVirtualKeyboardInputEngine::ReselectFlag
플래그 QVirtualKeyboardInputEngine::ReselectFlags
이 열거형은 단어 재선택 규칙을 지정합니다.
상수 | 값 | 설명 |
---|---|---|
QVirtualKeyboardInputEngine::ReselectFlag::WordBeforeCursor | 0x1 | 커서 앞에 있는 단어를 활성화합니다. 이 플래그를 단독으로 사용하는 경우 단어는 커서에서 정확히 끝나야 합니다. |
QVirtualKeyboardInputEngine::ReselectFlag::WordAfterCursor | 0x2 | 커서 뒤의 단어를 활성화합니다. 이 플래그를 단독으로 사용하는 경우 단어는 커서에서 정확히 시작해야 합니다. |
QVirtualKeyboardInputEngine::ReselectFlag::WordAtCursor | WordBeforeCursor | WordAfterCursor | 커서 위치에서 단어를 활성화합니다. 이 플래그는 위의 플래그를 조합한 것으로, 단어가 커서에서 시작하거나 중지할 수 없다는 점을 제외합니다. |
ReselectFlags 유형은 QFlags<ReselectFlag>에 대한 타입 정의입니다. ReselectFlag 값의 OR 조합을 저장합니다.
enum class QVirtualKeyboardInputEngine::TextCase
이 열거형은 입력 메서드의 텍스트 대소문자를 지정합니다.
Constant | 값 | 설명 |
---|---|---|
QVirtualKeyboardInputEngine::TextCase::Lower | 0 | 소문자 텍스트. |
QVirtualKeyboardInputEngine::TextCase::Upper | 1 | 대문자 텍스트. |
속성 문서
[read-only]
activeKey : const 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 : const QList<int>
이 속성은 활성 입력 방식에 사용할 수 있는 입력 모드를 저장합니다.
사용 가능한 입력 모드 목록은 입력 방법 및 로캘에 따라 달라집니다. 이 속성은 종속성 중 하나가 변경되면 업데이트됩니다.
액세스 기능:
QList<int> | inputModes() const |
알림 신호:
void | inputModesChanged() |
[read-only, since QtQuick.VirtualKeyboard 2.0]
patternRecognitionModes : const QList<int>
이 속성에는 사용 가능한 패턴 인식 모드 목록이 저장됩니다.
사용 가능한 패턴 인식 모드의 목록입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard 2.0에 도입되었습니다.
함수에 액세스합니다:
QList<int> | patternRecognitionModes() const |
알림 신호:
[read-only]
previousKey : const Qt::Key
이 속성에는 이전 활성 키가 저장됩니다.
이전에 누른 키입니다.
기능에 액세스합니다:
Qt::Key | previousKey() const |
알림 신호:
void | previousKeyChanged(Qt::Key key) |
[read-only]
wordCandidateListModel : QVirtualKeyboardSelectionListModel* const
단어 후보 목록의 목록 모델입니다.
이 속성을 사용하여 단어 후보 목록의 목록 모델에 액세스합니다.
함수 액세스
QVirtualKeyboardSelectionListModel * | wordCandidateListModel() const |
알림 신호:
void | wordCandidateListModelChanged() |
[read-only]
wordCandidateListVisibleHint : const 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
활성 입력 메서드를 반환합니다.
참고: 입력 메서드 프로퍼티에 대한 게터 함수입니다.
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
사용 가능한 입력 모드 목록을 반환합니다.
참고: 입력모드 프로퍼티에 대한 게터 함수입니다.
[signal]
void QVirtualKeyboardInputEngine::inputModesChanged()
사용 가능한 입력 모드가 변경되었음을 나타냅니다.
참고: 속성에 대한 알림 신호 inputModes.
QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const
지원되는 패턴 인식 모드의 목록을 반환합니다.
참고: 패턴 인식 모드 프로퍼티의 Getter 함수입니다.
[signal, since QtQuick.VirtualKeyboard 2.0]
void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()
사용 가능한 패턴 인식 모드가 변경되었음을 나타냅니다.
참고: 속성에 대한 알림 신호 patternRecognitionModes.
이 함수는 QtQuick.VirtualKeyboard 2.0에 도입되었습니다.
Qt::Key QVirtualKeyboardInputEngine::previousKey() const
이전에 활성화된 키를 반환하거나, 활성화된 키가 없는 경우 Qt::Key_unknown 을 반환합니다.
참고: 이전 키 속성에 대한 게터 함수입니다.
[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 에 의해 고유하게 식별됩니다. 입력 메서드가 이벤트를 수락하면 입력 엔진은 QVirtualKeyboardTrace 객체에 ID를 할당합니다.
patternRecognitionMode 은 패턴에 사용되는 인식 모드를 지정합니다.
현재 입력 메서드가 이벤트를 수락하면 이 상호작용과 관련된 QVirtualKeyboardTrace 객체를 반환합니다. 입력 메서드가 이벤트를 버리면 NULL 값을 반환합니다.
traceCaptureDeviceInfo 은 소스 장치에 대한 정보를 제공하고 traceScreenInfo 은 화면 컨텍스트에 대한 정보를 제공합니다.
정의에 따라 QVirtualKeyboardTrace 객체는 traceEnd() 메서드가 호출될 때까지 유효합니다.
추적 상호 작용은 traceEnd() 메서드를 호출하여 종료됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
이 함수는 QtQuick.VirtualKeyboard 2.0에 도입되었습니다.
[invokable]
bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)
입력 엔진과의 추적 상호 작용을 종료합니다.
trace 객체는 이 함수를 호출한 후 언제든 삭제할 수 있습니다.
추적 상호 작용이 수락된 경우(즉, 터치 이벤트가 다른 용도로 사용되지 않는 경우) 이 함수는 참을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 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)
키보드 레이어에 의해 호출되어 text 및 modifiers 과 함께 key 이 눌려졌음을 나타냅니다.
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 을 참조하세요.
© 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.