Тип QML InputMethod

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

Заявление об импорте: import QtQuick.VirtualKeyboard 2.1

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

Свойства

inputContext : InputContext
inputEngine : InputEngine

Сигналы

selectionListActiveItemChanged(int type, int index)
selectionListChanged(int type)
selectionListsChanged()

Методы

bool clickPreeditText(int cursorPosition)
list<int> inputModes(string locale)
bool keyEvent(int key, string text, int modifiers)
list<int> patternRecognitionModes()
bool reselect(int cursorPosition, int reselectFlags)
reset()
var selectionListData(int type, int index, int role)
int selectionListItemCount(int type)
void selectionListItemSelected(int type, int index)
list<int> selectionLists()
bool setInputMode(string locale, int inputMode)
bool setTextCase(int textCase)
Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
bool traceEnd(Trace trace)
update()

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

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

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

inputContext : InputContext

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

inputEngine : InputEngine

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

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

selectionListActiveItemChanged(int type, int index)

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

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

selectionListChanged(int type)

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

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

`[since QtQuick.VirtualKeyboard 2.2]` selectionListsChanged()

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

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

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

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

`[since QtQuick.VirtualKeyboard 2.4]` bool clickPreeditText(int cursorPosition)

Вызывается при щелчке пользователя по предварительно редактируемому тексту в позиции cursorPosition.

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

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

list<int> inputModes(string locale)

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

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

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

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

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

`[since QtQuick.VirtualKeyboard 2.0]` list<int> patternRecognitionModes()

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

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

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

`[since QtQuick.VirtualKeyboard 2.0]` bool reselect(int cursorPosition, int reselectFlags)

Этот метод пытается повторно выбрать слово, расположенное в позиции cursorPosition. Значения reselectFlags определяют правила выбора слова по отношению к позиции курсора.

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

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

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

reset()

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

var selectionListData(int type, int index, int role)

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

int selectionListItemCount(int type)

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

void selectionListItemSelected(int type, int index)

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

list<int> selectionLists()

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

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

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

bool setInputMode(string locale, int inputMode)

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

bool setTextCase(int textCase)

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

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

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

`[since QtQuick.VirtualKeyboard 2.0]` Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

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

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

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

`[since QtQuick.VirtualKeyboard 2.0]` bool traceEnd(Trace trace)

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

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