Класс QInputMethod

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

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

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

Свойства

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

Открытые слоты

Сигналы

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

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

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

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

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

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

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

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

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

[slot] void QInputMethod::commit()

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

[slot] void QInputMethod::hide()

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

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

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

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

[slot] void QInputMethod::reset()

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

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

[slot] void QInputMethod::show()

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

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

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

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

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

[since 5.1] QRectF QInputMethod::inputItemRectangle() const

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

Эта функция была введена в Qt 5.1.

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

QTransform QInputMethod::inputItemTransform() const

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

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

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

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

[since 5.1] 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().