Класс QVirtualKeyboardInputEngine

Класс InputEngine предоставляет механизм ввода, поддерживающий интеграцию C++ и QML. Подробнее...

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

Открытые типы

Свойства

Открытые функции

Сигналы

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

Механизм ввода отвечает за маршрутизацию событий ввода в методы ввода. Фактическая логика ввода реализована методами ввода.

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

Описание типа члена

enum QVirtualKeyboardInputEngine::InputMode

Это перечисление задаёт режим ввода для метода ввода.

enum QVirtualKeyboardInputEngine::PatternRecognitionMode

Этот перечисление определяет режим ввода для метода ввода.

enum QVirtualKeyboardInputEngine::ReselectFlagflags QVirtualKeyboardInputEngine::ReselectFlags

Это перечисление определяет правила для повторного выбора слов.

Тип ReselectFlags — это псевдоним для QFlags<ReselectFlag>. Он хранит логическое ИЛИ комбинацию значений ReselectFlag.

enum QVirtualKeyboardInputEngine::TextCase

Это перечисление определяет регистр текста для метода ввода.

Документация по членам-функциям

void QVirtualKeyboardInputEngine::activeKeyChanged(Qt::Key key)

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

Примечание: Сигнал уведомления для свойства activeKey.

void QVirtualKeyboardInputEngine::inputMethodChanged()

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

Примечание: Сигнал уведомления для свойства inputMethod.

void QVirtualKeyboardInputEngine::inputMethodReset()

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

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

void QVirtualKeyboardInputEngine::inputMethodUpdate()

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

void QVirtualKeyboardInputEngine::inputModeChanged()

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

Примечание: Сигнал уведомления для свойства inputMode.

void QVirtualKeyboardInputEngine::inputModesChanged()

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

Примечание: Сигнал уведомления для свойства inputModes.

void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()

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

Это функция была введена в QtQuick.VirtualKeyboard 2.0.

Примечание: Сигнал уведомления для свойства patternRecognitionModes.

void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)

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

Примечание: Сигнал уведомления для свойства previousKey.

void QVirtualKeyboardInputEngine::virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat)

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

Qt::Key QVirtualKeyboardInputEngine::activeKey() const

Возвращает текущий активный ключ или Qt::Key_unknown, если нет активного ключа.

Примечание: Функция-геттер для свойства activeKey.

QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const

Возвращает InputContext экземпляр, связанный с механизмом ввода.

QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const

Возвращает активный механизм ввода.

Примечание: Функция-геттер для свойства inputMethod.

См. также setInputMethod().

QList<int> QVirtualKeyboardInputEngine::inputModes() const

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

Примечание: Функция-геттер для свойства inputModes.

QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const

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

Примечание: Функция-геттер для свойства patternRecognitionModes.

Qt::Key QVirtualKeyboardInputEngine::previousKey() const

Возвращает предыдущий активный ключ или Qt::Key_unknown, если не было активных ключей.

Примечание: Функция-геттер для свойства previousKey.

bool QVirtualKeyboardInputEngine::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

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

Функция возвращает true , если слово было успешно перевыбрано.

Эта функция была добавлена в QtQuick.VirtualKeyboard 2.0.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)

Устанавливает inputMethod в качестве активного механизма ввода.

Примечание: Функция-сеттер для свойства inputMethod.

См. также inputMethod().

QVirtualKeyboardTrace *QVirtualKeyboardInputEngine::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

Начинает трассировку взаимодействия с механизмом ввода.

Трассировка уникально идентифицируется по traceId. Механизм ввода примет идентификатор у объекта QVirtualKeyboardTrace, если механизм ввода принимает событие.

patternRecognitionMode определяет режим распознавания шаблона.

Если текущий механизм ввода принимает событие, возвращает объект QVirtualKeyboardTrace, связанный с этим взаимодействием. Если механизм ввода игнорирует событие, возвращает NULL.

traceCaptureDeviceInfo содержит информацию об устройстве-источнике, а traceScreenInfo - информацию о контексте экрана.

По определению, объект QVirtualKeyboardTrace остается допустимым до вызова метода traceEnd().

Взаимодействие трассировки завершается вызовом метода traceEnd().

Эта функция была добавлена в QtQuick.VirtualKeyboard 2.0.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)

Завершает взаимодействие трассировки с механизмом ввода.

Объект trace может быть удален в любой момент после вызова этой функции.

Функция возвращает true, если взаимодействие трассировки было принято (т.е. события касания не должны использоваться для чего-либо ещё).

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QVirtualKeyboardInputEngine::virtualKeyCancel()

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

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

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

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat)

Вызывается слоем клавиатуры, чтобы указать, что key была нажата с заданным text и modifiers.

key устанавливается как активная клавиша (клавиша вниз). Фактическое событие клавиши генерируется, когда клавиша отпускается методом virtualKeyRelease(). Событие нажатия клавиши может быть отброшено вызовом virtualKeyCancel().

Нажатие клавиши также запускает таймер повторения клавиши, если repeat равно true.

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

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

См. также virtualKeyCancel() и virtualKeyRelease().

bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

Отпускает клавишу key. Метод излучает событие клавиши для механизма ввода, если событие не было сгенерировано повторяющимся таймером. text и modifiers передаются механизму ввода.

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

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.