Тип QML InputEngine

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

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

Свойства

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : list<int>
• patternRecognitionModes : list<int>
• previousKey : int
• wordCandidateListModel : SelectionListModel
• 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)

Методы

• Trace 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 Режим ввода тайского языка.
• InputEngine.InputMode.Stroke Режим ввода штрихов для китайского языка.
• InputEngine.InputMode.Romaji Режим ввода ромадзи для японского языка.

inputModes : list<int>

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

[since QtQuick.VirtualKeyboard 2.0] patternRecognitionModes : list<int>

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

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

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

previousKey : int

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

wordCandidateListModel : SelectionListModel

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

wordCandidateListVisibleHint : bool

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

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

void activeKeyChanged(int key)

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

Примечание: Соответствующий обработчик — onActiveKeyChanged.

void inputMethodChanged()

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

Примечание: Соответствующий обработчик — onInputMethodChanged.

void inputMethodReset()

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

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

Примечание: Соответствующий обработчик — onInputMethodReset.

void inputMethodUpdate()

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

Примечание: Соответствующий обработчик — onInputMethodUpdate.

void inputModeChanged()

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

Примечание: Соответствующий обработчик — onInputModeChanged.

void inputModesChanged()

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

Примечание: Соответствующий обработчик — onInputModesChanged.

[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

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

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

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

Примечание: Соответствующий обработчик — onPatternRecognitionModesChanged.

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

void previousKeyChanged(int key)

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

Примечание: Соответствующий обработчик — onPreviousKeyChanged.

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

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

Примечание: Соответствующий обработчик — onVirtualKeyClicked.

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

[since QtQuick.VirtualKeyboard 2.0] Trace 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.

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

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

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

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

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

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

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