Тип QML InputMethod

Базовый тип для создания метода ввода в QML. Подробнее...

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

Свойства

• inputContext : InputContext
• inputEngine : InputEngine

Сигналы

• selectionListActiveItemChanged(тип, int индекс)
• selectionListChanged(тип)
• selectionListsChanged()

Методы

• bool clickPreeditText(позиция курсора)
• list<int> inputModes(язык)
• bool keyEvent(клавиша, string текст, int модификаторы)
• list<int> patternRecognitionModes()
• bool reselect(позиция курсора, int флаги перевыбора)
• reset()
• var selectionListData(тип, int индекс, int роль)
• int selectionListItemCount(тип)
• void selectionListItemSelected(тип, int индекс)
• list<int> selectionLists()
• bool setInputMode(язык, int режим ввода)
• bool setTextCase(регистр текста)
• Trace traceBegin(идентификатор трассировки, int режим распознавания шаблонов, var устройство захвата трассировки, var информация о экране)
• bool traceEnd(трассировка)
• update()

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

Тип InputMethod позволяет создавать настраиваемый метод ввода, который можно назначить InputEngine.

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

inputContext : InputContext

Контекст ввода.

inputEngine : InputEngine

Двигатель ввода.

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

selectionListActiveItemChanged(тип, int индекс)

Метод ввода отправляет этот сигнал, когда текущий индекс изменился в списке выбора, идентифицированном по типу.

selectionListChanged(тип)

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

selectionListsChanged()

Метод ввода отправляет этот сигнал, когда типы списков выбора изменились. Этот сигнал вызовет метод selectionLists(), позволяя методу ввода обновить типы списков выбора.

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

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

bool clickPreeditText(позиция курсора)

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

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

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

list<int> inputModes(язык)

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

bool keyEvent(клавиша, string текст, int модификаторы)

Цель этого метода — обработать события нажатия клавиш, сгенерированные двигателем ввода.

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

Метод возвращает true если событие клавиши было успешно обработано. Если возвращаемое значение false, событие клавиши перенаправляется на метод по умолчанию для дальнейшей обработки.

list<int> patternRecognitionModes()

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

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

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

bool reselect(позиция курсора, int флаги перевыбора)

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

• InputEngine.WordBeforeCursor Активировать слово перед курсором. При использовании этого флага исключительно, слово должно заканчиваться точно на курсоре.
• InputEngine.WordAfterCursor Активировать слово после курсора. При использовании этого флага исключительно, слово должно начинаться точно на курсоре.
• InputEngine.WordAtCursor Активировать слово на курсоре. Этот флаг является комбинацией вышеуказанных флагов за исключением того, что слово не может начинаться или заканчиваться на курсоре.

Метод возвращает true если слово было успешно перевыбрано.

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

reset()

Этот метод вызывается двигателем ввода, когда этот метод ввода необходимо сбросить. Метод ввода должен сбросить только своё внутреннее состояние. Основное различие от метода update() заключается в том, что reset() изменяет только состояние метода ввода; он не должен изменять контекст ввода.

var selectionListData(тип, int индекс, int роль)

Возвращает данные элемента для списка выбора, идентифицированного по типу. Параметр роль указывает какие данные запрашиваются. Параметр индекс - нулевой индекс в списке выбора.

int selectionListItemCount(тип)

Возвращает количество элементов в списке выбора, идентифицированном по типу.

void selectionListItemSelected(тип, int индекс)

Этот метод вызывается, когда пользователь выбрал элемент с индексом. Список выбора определяется параметром тип.

list<int> selectionLists()

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

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

Метод ввода может запросить двигатель ввода обновить списки выбора в любое время, отправив сигнал selectionListsChanged(). Этот сигнал вызовет этот метод, позволяя методу ввода обновить типы списков выбора.

bool setInputMode(язык, int режим ввода)

Изменяет режим ввода и язык для этого метода ввода. Метод возвращает true если успешно.

bool setTextCase(регистр текста)

Обновляет регистр текста для этого метода ввода. Метод возвращает true если успешно.

Возможные значения для типа текста:

• InputEngine.Lower Текст в нижнем регистре.
• InputEngine.Upper Текст в верхнем регистре.

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

Этот метод вызывается при начале взаимодействия с отслеживанием со значением patternRecognitionMode. Отслеживание уникально идентифицируется по traceId. traceCaptureDeviceInfo предоставляет информацию об устройстве-источнике, а traceScreenInfo — информацию о контексте экрана.

Если метод ввода принимает событие и хочет захватить данные отслеживания, он должен вернуть новый объект Trace. Этот объект должен оставаться валидным до тех пор, пока не будет вызван метод InputMethod.traceEnd(). Если отслеживание отображается на экране, оно останется там до уничтожения объекта Trace.

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

bool traceEnd(trace)

Этот метод вызывается при завершении взаимодействия с отслеживанием. Метод ввода должен уничтожить объект trace в какой-то момент после вызова этой функции. См. Trace API для методов ввода о том, как получить собранные данные.

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

update()

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