Класс QInputMethod

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

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

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

Свойства

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

Публичные функции

• 31 функция унаследована от QObject

Публичные слоты

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

Сигналы

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

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

• 9 статических публичных членов унаследованы от 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(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 истинно) или hide() (если visible ложно).

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

[slot] void QInputMethod::show()

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

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

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

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

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