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::Latin0라틴 텍스트의 기본 입력 모드입니다.
QVirtualKeyboardInputEngine::InputMode::Numeric1숫자 입력만 허용됩니다.
QVirtualKeyboardInputEngine::InputMode::Dialable2다이얼 가능한 입력만 허용됩니다.
QVirtualKeyboardInputEngine::InputMode::Pinyin3중국어 병음 입력 모드입니다.
QVirtualKeyboardInputEngine::InputMode::Cangjie4중국어용 병음 입력 모드입니다.
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일본어 로마지 입력 모드.

enum class QVirtualKeyboardInputEngine::PatternRecognitionMode

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

Constant설명
QVirtualKeyboardInputEngine::PatternRecognitionMode::None0패턴 인식을 사용할 수 없습니다.
QVirtualKeyboardInputEngine::PatternRecognitionMode::PatternRecognitionDisabledNoneobsolete 패턴 인식 모드::없음 사용
QVirtualKeyboardInputEngine::PatternRecognitionMode::Handwriting1필기 인식을 위한 패턴 인식 모드입니다.
QVirtualKeyboardInputEngine::PatternRecognitionMode::HandwritingRecoginitionHandwritingobsolete 패턴 인식 모드::손글씨 사용

열거형 클래스 QVirtualKeyboardInputEngine::ReselectFlag
플래그 QVirtualKeyboardInputEngine::ReselectFlags

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

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

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

enum class QVirtualKeyboardInputEngine::TextCase

이 열거형은 입력 메서드의 텍스트 대소문자를 지정합니다.

Constant설명
QVirtualKeyboardInputEngine::TextCase::Lower0소문자 텍스트.
QVirtualKeyboardInputEngine::TextCase::Upper1대문자 텍스트.

속성 문서

[read-only] activeKey : const 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 : const QList<int>

이 속성은 활성 입력 방식에 사용할 수 있는 입력 모드를 저장합니다.

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

액세스 기능:

QList<int> inputModes() const

알림 신호:

[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, textmodifiers 에 대한 키 클릭 이벤트를 발생시킵니다. 키 이벤트가 입력 엔진에서 수락되면 true 을 반환합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[signal] void QVirtualKeyboardInputEngine::virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat)

주어진 textmodifiers 과 함께 가상의 key 을 클릭했음을 나타냅니다. isAutoRepeat 은 키를 누르고 있는 동안 이벤트가 자동으로 반복되는지를 나타냅니다. 이 신호는 입력 메서드가 키 이벤트를 처리한 후에 방출됩니다.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat)

키보드 레이어에 의해 호출되어 textmodifiers 과 함께 key 이 눌려졌음을 나타냅니다.

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

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

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

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

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

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

입력 엔진에서 키를 수락한 경우 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.