Тип QML InputEngine

Преобразует пользовательский ввод в методы ввода. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : список<int>
• patternRecognitionModes : список<int>
• previousKey : int
• wordCandidateListModel : QVirtualKeyboardSelectionListModel
• wordCandidateListVisibleHint : bool

Сигналы

• void activeKeyChanged(int key)
• void inputMethodChanged()
• void inputMethodReset()
• void inputMethodUpdate()
• void inputModeChanged()
• void inputModesChanged()
• void patternRecognitionModesChanged()
• void previousKeyChanged(int key)
• void virtualKeyClicked(int key, string text, int modifiers)

Методы

• QVirtualKeyboardTrace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
• bool traceEnd(Trace trace)
• void virtualKeyCancel()
• bool virtualKeyClick(int key, string text, int modifiers)
• bool virtualKeyPress(int key, string text, int modifiers, bool repeat)
• bool virtualKeyRelease(int key, string text, int modifiers)

Подробное описание

Двигатель ввода отвечает за маршрутизацию событий ввода к методам ввода. Фактическая логика ввода реализуется методами ввода.

Двигатель ввода также включает в себя метод ввода по умолчанию, который отвечает за обработку по умолчанию, если активный метод ввода не обрабатывает событие.

Документация свойств

activeKey : int

Нажатая в данный момент клавиша.

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 Режим ввода тайского языка.

inputModes : список<int>

Список доступных режимов ввода зависит от метода ввода и локали. Это свойство обновляется при изменении любого из зависимых параметров.

patternRecognitionModes : список<int>

Список доступных режимов распознавания шаблонов.

Возможные значения:

Это свойство было добавлено в QtQuick.VirtualKeyboard 2.0.

previousKey : int

Предыдущая нажатая клавиша.

wordCandidateListModel : QVirtualKeyboardSelectionListModel

Используйте это свойство для доступа к модели списка предложений слов.

wordCandidateListVisibleHint : bool

Используйте это свойство для проверки, должен ли список предложений слов отображаться в пользовательском интерфейсе.

Документация сигналов

void activeKeyChanged(int key)

Указывает, что активная клавиша изменилась.

void inputMethodChanged()

Указывает, что метод ввода изменился.

void inputMethodReset()

Вызывается, когда метод ввода необходимо сбросить.

Примечание: Этот сигнал автоматически подключается к QVirtualKeyboardAbstractInputMethod::reset() и InputMethod::reset() при активации метода ввода.

void inputMethodUpdate()

Примечание: Этот сигнал автоматически подключается к QVirtualKeyboardAbstractInputMethod::update() и InputMethod::update() при активации метода ввода.

void inputModeChanged()

Указывает, что режим ввода изменился.

void inputModesChanged()

Указывает, что доступные режимы ввода изменились.

void patternRecognitionModesChanged()

Указывает, что доступные режимы распознавания шаблонов изменились.

Предопределённые режимы распознавания шаблонов:

• InputEngine.PatternRecognitionMode.None Распознавание шаблонов недоступно.
• InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete Используйте InputEngine.PatternRecognitionMode.None
• InputEngine.PatternRecognitionMode.Handwriting Режим распознавания шаблонов для распознавания рукописного ввода.
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Используйте InputEngine.PatternRecognitionMode.Handwriting

Этот сигнал был добавлен в QtQuick.VirtualKeyboard 2.0.

void previousKeyChanged(int key)

Указывает, что предыдущая клавиша изменилась.

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

Указывает, что виртуальная клавиша key была нажата с заданным text и modifiers. Этот сигнал испускается после обработки события клавиши методом ввода.

Документация по методам

QVirtualKeyboardTrace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

Начинает взаимодействие отслеживания с движком ввода.

Отслеживание уникально идентифицируется по traceId. Движок ввода назначит идентификатор объекту Trace, если метод ввода примет событие.

patternRecognitionMode определяет режим распознавания, используемый для шаблона.

Если текущий метод ввода принимает событие, возвращается объект Trace, связанный с этим взаимодействием. Если метод ввода отбрасывает событие, возвращается значение null.

traceCaptureDeviceInfo предоставляет информацию об устройстве-источнике, а traceScreenInfo — о контексте экрана.

По определению, объект Trace остается допустимым до тех пор, пока не будет вызван метод traceEnd().

Взаимодействие отслеживания завершается вызовом метода InputEngine.traceEnd().

Этот метод был введен в QtQuick.VirtualKeyboard 2.0.

bool traceEnd(Trace trace)

Завершает взаимодействие отслеживания с движком ввода.

Объект trace может быть удален в любой момент после вызова этой функции.

Функция возвращает true, если взаимодействие отслеживания было принято (т.е. события касания не должны использоваться для чего-либо другого).

void virtualKeyCancel()

Возвращает активное состояние клавиши, не испуская события клавиши. Этот метод полезен, когда пользователь отказывается от текущей клавиши, и состояние клавиши необходимо восстановить.

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

Инициирует событие нажатия клавиши для заданной key, text и modifiers. Возвращает true если событие клавиши было принято движком ввода.

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

Вызывается слоем клавиатуры для указания того, что клавиша key была нажата с заданным text и modifiers.

Ключ устанавливается как активная клавиша (клавиша вниз). Фактическое событие клавиши срабатывает при отпускании клавиши методом virtualKeyRelease(). Событие нажатия клавиши можно отбросить, вызвав virtualKeyCancel().

Нажатие клавиши также инициирует таймер повтора клавиши, если repeat равно true.

Возвращает true если клавиша была принята этим движком ввода.

См. также virtualKeyCancel() и virtualKeyRelease().

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

Отпускает клавишу по key. Метод испускает событие клавиши для метода ввода, если событие не было сгенерировано повторяющимся таймером. text и modifiers передаются методу ввода.

Возвращает true если клавиша была принята движком ввода.