Тип QML InputMethod

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

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

Свойства

• inputContext : InputContext
• inputEngine : InputEngine

Сигналы

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

Методы

• 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.

selectionListChanged(int type)

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

selectionListsChanged()

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

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

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

list<int> inputModes(string locale)

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

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

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

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

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

list<int> patternRecognitionModes()

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

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

Этот метод был добавлен в 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)

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

list<int> selectionLists()

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

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

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

bool setInputMode(string locale, int inputMode)

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

bool setTextCase(int textCase)

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

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

• InputEngine.Lower Текст строчными буквами.
• InputEngine.Upper Текст заглавными буквами.

Trace traceBegin(int 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 Trace для получения доступа к собранным данным.

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

update()

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