Класс QVirtualKeyboardInputEngine

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

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

Типы

Свойства

• 1 свойство унаследовано от QObject

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

• 31 открытая функция унаследована от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические публичные члены

• 9 статических публичных членов унаследованы от QObject

Дополнительные унаследованные члены

• 1 публичный слот унаследован от QObject
• 9 защищенных функций унаследованы от QObject

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

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

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

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

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

enum QVirtualKeyboardInputEngine::InputMode

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

enum QVirtualKeyboardInputEngine::PatternRecognitionMode

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

enum QVirtualKeyboardInputEngine::ReselectFlagflags QVirtualKeyboardInputEngine::ReselectFlags

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

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

enum QVirtualKeyboardInputEngine::TextCase

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

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

Qt::Key QVirtualKeyboardInputEngine::activeKey() const

Возвращает активную клавишу или Qt::Key_unknown, если активная клавиша отсутствует.

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

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

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

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

QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const

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

QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const

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

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

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

void QVirtualKeyboardInputEngine::inputMethodChanged()

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

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

void QVirtualKeyboardInputEngine::inputMethodReset()

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

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

void QVirtualKeyboardInputEngine::inputMethodUpdate()

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

void QVirtualKeyboardInputEngine::inputModeChanged()

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

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

QList<int> QVirtualKeyboardInputEngine::inputModes() const

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

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

void QVirtualKeyboardInputEngine::inputModesChanged()

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

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

QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const

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

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

[signal] void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()

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

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

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

Qt::Key QVirtualKeyboardInputEngine::previousKey() const

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

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

[signal] void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)

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

Примечание: Сигнальная функция-нотификатор для свойства 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.

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

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

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

Вызывается слоем клавиатуры для указания нажатия клавиши key с заданным текстом text и модификаторами modifiers.

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

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

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

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

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

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

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

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