Класс QInputMethod

Класс QInputMethod предоставляет доступ к активному методу ввода текста. Подробнее...

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

Типы публичного доступа

Свойства

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

Функции публичного доступа

• 34 функции публичного доступа унаследованы от QObject

Свойства публичного доступа

• 1 свойство публичного доступа унаследовано от QObject

Сигналы

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

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

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

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

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

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

Класс QInputMethod предоставляет доступ к активному методу ввода текста.

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

Qt Quick также предоставляет доступ к QInputMethod в QML через глобальный объект Qt в виде свойства Qt.inputMethod.

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

перечисление QInputMethod::Action

Указывает тип действия, выполненного пользователем.

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

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

[slot] void QInputMethod::commit()

Подтверждает слово, которое пользователь вводит в настоящее время, в редакторе. Функция в основном необходима методам ввода с функциями предсказания текста и методам, в которых сценарий, используемый для набора символов, отличается от сценария, который фактически добавляется в редактор. Любой вид действия, прерывающего написание текста, должен очистить состояние набора текста, вызвав функцию commit(), например, при перемещении курсора в другое место.

[slot] void QInputMethod::hide()

Запрашивает закрытие виртуальной клавиатуры.

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

QRectF QInputMethod::inputItemRectangle() const

Возвращает геометрию элемента ввода в координатах элемента ввода.

Функция была добавлена в Qt 5.1.

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

QTransform QInputMethod::inputItemTransform() const

Возвращает преобразование из координат элемента ввода в координаты окна.

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

[slot] void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

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

[static] QVariant QInputMethod::queryFocusObject(Qt::InputMethodQuery query, QVariant argument)

Отправляет query текущему объекту фокуса с параметрами argument и возвращает результат.

[slot] void QInputMethod::reset()

Сбрасывает состояние метода ввода. Например, текстовый редактор обычно вызывает этот метод перед вставкой текста, чтобы подготовить виджет к приёму текста.

Метод ввода сбрасывается автоматически при изменении фокусированного редактора.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Устанавливает геометрию элемента ввода в rect в координатах элемента ввода. Это необходимо обновлять фокусированному окну, например, QQuickCanvas, каждый раз, когда элемент перемещается в сцене или изменяется фокус.

Функция была добавлена в Qt 5.1.

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

void QInputMethod::setInputItemTransform(const QTransform &transform)

Устанавливает преобразование из координат элемента ввода в координаты окна на transform. Преобразование элемента необходимо обновлять фокусированному окну, например, QQuickCanvas, каждый раз, когда элемент перемещается в сцене.

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

void QInputMethod::setVisible(bool visible)

Управляет видимостью клавиатуры. Эквивалентно вызову show() (если visible true) или hide() (если visible false).

См. также isVisible(), show() и hide().

[slot] void QInputMethod::show()

Запрашивает открытие виртуальной клавиатуры. Если платформа не предоставляет виртуальную клавиатуру, видимость остаётся ложной.

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

[slot] void QInputMethod::update(Qt::InputMethodQueries queries)

Вызывается элементом ввода, чтобы уведомить платформенные методы ввода о изменениях состояния атрибутов запроса метода ввода редактора. При вызове функции параметр queries должен использоваться для указания изменений, которые метод ввода может использовать для запросов атрибутов, которые его интересуют QInputMethodQueryEvent.

В частности, вызов обновления всякий раз, когда изменяется позиция курсора, важен, поскольку это часто приводит к изменению и других атрибутов запроса, таких как окружающий текст и выделенный текст. Атрибуты, которые часто изменяются вместе с позицией курсора, объединены в значение Qt::ImQueryInput для удобства.