Тип 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.Latin Режим ввода по умолчанию для латинского текста.
• InputEngine.Numeric Разрешен только числовой ввод.
• InputEngine.Dialable Разрешен только набираемый ввод.
• InputEngine.Pinyin Режим ввода Пинъин для китайского языка.
• InputEngine.Cangjie Режим ввода Цанцзе для китайского языка.
• InputEngine.Zhuyin Режим ввода Чжуйинь для китайского языка.
• InputEngine.Hangul Режим ввода Хангуль для корейского языка.
• InputEngine.Hiragana Режим ввода Хирагана для японского языка.
• InputEngine.Katakana Режим ввода Катакана для японского языка.
• InputEngine.FullwidthLatin Режим ввода латинских символов в полную ширину для восточноазиатских языков.
• InputEngine.Greek Режим ввода греческого языка.
• InputEngine.Cyrillic Режим ввода кириллицы.
• InputEngine.Arabic Режим ввода арабского языка.
• InputEngine.Hebrew Режим ввода иврита.
• InputEngine.ChineseHandwriting Рукописный ввод китайского языка.
• InputEngine.JapaneseHandwriting Рукописный ввод японского языка.
• InputEngine.KoreanHandwriting Рукописный ввод корейского языка.

inputModes : list<int>

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

patternRecognitionModes : list<int>

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

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

previousKey : int

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

wordCandidateListModel : SelectionListModel

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

wordCandidateListVisibleHint : bool

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

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

void activeKeyChanged(int key)

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

void inputMethodChanged()

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

void inputMethodReset()

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

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

void inputMethodUpdate()

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

void inputModeChanged()

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

void inputModesChanged()

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

void patternRecognitionModesChanged()

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

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

• InputEngine.PatternRecognitionDisabled Распознавание шаблонов недоступно.
• InputEngine.HandwritingRecoginition Режим распознавания шаблонов для распознавания рукописного ввода.

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

void previousKeyChanged(int key)

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

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

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

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

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 если клавиша была принята движком ввода.