Тип 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 Режим ввода полноширинного латинского шрифта для восточноазиатских языков.

inputModes : list<int>

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

patternRecognitionModes : list<int>

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

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

Этот сигнал QML был введен в 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().

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