Тип QML InputEngine

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

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

Свойства

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : list<int>
• patternRecognitionModes : list<int>
• previousKey : int
• wordCandidateListModel : QVirtualKeyboardSelectionListModel
• wordCandidateListVisibleHint : bool

Сигналы

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

Методы

• QVirtualKeyboardTrace traceBegin(traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
• bool traceEnd(trace)
• void virtualKeyCancel()
• bool virtualKeyClick(key, string text, int modifiers)
• bool virtualKeyPress(key, string text, int modifiers, bool repeat)
• bool virtualKeyRelease(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 : list<int>

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

patternRecognitionModes : list<int>

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

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

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

previousKey : int

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

wordCandidateListModel : QVirtualKeyboardSelectionListModel

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

wordCandidateListVisibleHint : bool

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

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

void activeKeyChanged(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(key)

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

void virtualKeyClicked(key, string text, int modifiers)

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

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

QVirtualKeyboardTrace traceBegin(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 может быть отброшен в любой момент после вызова этой функции.

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

void virtualKeyCancel()

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

bool virtualKeyClick(key, string text, int modifiers)

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

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

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

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

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

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

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

bool virtualKeyRelease(key, string text, int modifiers)

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

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