Класс QInputMethod

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

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

Типы

Свойства

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

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

• 31 открытая функция унаследована от 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 true) или hide() (если visible false).

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

[slot] void QInputMethod::show()

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

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

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

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

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