Класс 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 для удобства.

QRectF QInputMethod::inputItemRectangle() const

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

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

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

QTransform QInputMethod::inputItemTransform() const

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

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

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

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

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().