Класс QInputMethod

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

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

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

Свойства

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

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

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

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

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

Сигналы

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

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

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

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

• 9 защищённых функций унаследованы от 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(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 истинно) или hide() (если visible ложно).

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

[slot] void QInputMethod::show()

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

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

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

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

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