Класс QVirtualKeyboardAbstractInputMethod
Базовый класс для методов ввода. Подробнее...
| Заголовок: | #include <QVirtualKeyboardAbstractInputMethod> |
| qmake: | QT += virtualkeyboard |
| Наследует: | QObject |
Открытые функции
| QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr) | |
| virtual | ~QVirtualKeyboardAbstractInputMethod() |
| virtual bool | clickPreeditText(int cursorPosition) |
| QVirtualKeyboardInputContext * | inputContext() const |
| QVirtualKeyboardInputEngine * | inputEngine() const |
| virtual QList<QVirtualKeyboardInputEngine::InputMode> | inputModes(const QString &locale) = 0 |
| virtual bool | keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) = 0 |
| virtual QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> | patternRecognitionModes() const |
| virtual bool | reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags) |
| virtual QVariant | selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role) |
| virtual int | selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type) |
| virtual void | selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index) |
| virtual bool | selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index) |
| virtual QList<QVirtualKeyboardSelectionListModel::Type> | selectionLists() |
| virtual bool | setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode) = 0 |
| virtual bool | setTextCase(QVirtualKeyboardInputEngine::TextCase textCase) = 0 |
| virtual QVirtualKeyboardTrace * | traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo) |
| virtual bool | traceEnd(QVirtualKeyboardTrace *trace) |
- 31 открытая функция унаследованная от QObject
Открытые слоты
| virtual void | reset() |
| virtual void | update() |
- 1 открытый слот унаследованный от QObject
Сигналы
| void | selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index) |
| void | selectionListChanged(QVirtualKeyboardSelectionListModel::Type type) |
| void | selectionListsChanged() |
- 2 сигнала унаследованных от QObject
Статические открытые члены
| const QMetaObject | staticMetaObject |
- 9 статических открытых членов унаследованных от QObject
Дополнительные унаследованные члены
Подробное описание
Базовый класс для методов ввода.
Используйте этот класс, если хотите реализовать пользовательский метод ввода с помощью языка C/C++.
Документация по методам-членам
QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)
Создаёт метод ввода с parent.
[virtual] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()
Уничтожает метод ввода и освобождает все выделенные ресурсы.
[virtual] bool QVirtualKeyboardAbstractInputMethod::clickPreeditText(int cursorPosition)
Вызывается, когда пользователь нажимает на текст предварительного редактирования в позиции cursorPosition.
Функция должна вернуть true если она обрабатывает событие. В противном случае ввод перенаправляется в reselect() для дальнейшей обработки.
Эта функция была добавлена в QtQuick.VirtualKeyboard 2.4.
QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const
Возвращает контекст ввода, связанный с методом ввода. Этот метод возвращает NULL если метод ввода не активен.
QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const
Возвращает движок ввода, связанный с методом ввода. Этот метод возвращает NULL если метод ввода не активен.
[pure virtual] QList<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)
Возвращает список режимов ввода для locale.
[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
Цель этого метода — обработка событий нажатия клавиш, сгенерированных движком ввода.
Параметр key указывает код клавиши для обработки. Код клавиши не различает заглавные и строчные буквы. Параметр text содержит текст Юникод для клавиши. Параметр modifiers содержит модификаторы клавиш, применимые к клавише.
Этот метод возвращает true если событие нажатия клавиши было успешно обработано. Если возвращаемое значение false, событие нажатия клавиши перенаправляется на стандартный метод ввода для дальнейшей обработки.
[virtual] QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> QVirtualKeyboardAbstractInputMethod::patternRecognitionModes() const
Возвращает список поддерживаемых режимов распознавания шаблонов.
Этот метод вызывается движком ввода для запроса списка поддерживаемых режимов распознавания шаблонов.
Эта функция была введена в QtQuick.VirtualKeyboard 2.0.
[virtual] bool QVirtualKeyboardAbstractInputMethod::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)
Эта функция пытается повторно выбрать слово, расположенное по позиции cursorPosition. Флаги reselectFlags определяют правила выбора слова относительно позиции курсора.
Функция возвращает true если слово было успешно перевыбрано.
Эта функция была введена в QtQuick.VirtualKeyboard 2.0.
[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()
Этот метод вызывается движком ввода, когда метод ввода требуется сбросить. Метод ввода должен сбросить только своё внутреннее состояние. Основное отличие от метода update() заключается в том, что reset() изменяет только состояние метода ввода, т. е. он не должен изменять контекст ввода.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)
Метод ввода излучает этот сигнал, когда текущий индекс index изменился в списке выбора, определённом по type.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)
Метод ввода излучает этот сигнал, когда содержимое списка выбора изменилось. Параметр type указывает, какой список выбора изменился.
[virtual] QVariant QVirtualKeyboardAbstractInputMethod::selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)
Возвращает данные элемента для списка выбора, идентифицированного по type. Параметр role определяет, какие данные запрашиваются. Параметр index — индекс элемента в списке (начиная с нуля).
[virtual] int QVirtualKeyboardAbstractInputMethod::selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)
Возвращает количество элементов в списке выбора, идентифицированном по type.
[virtual] void QVirtualKeyboardAbstractInputMethod::selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)
Этот метод вызывается, когда пользователь выбрал элемент с индексом index. Список выбора идентифицируется параметром type.
[virtual] bool QVirtualKeyboardAbstractInputMethod::selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)
Этот метод вызывается, когда элемент с индексом index должен быть удалён из словаря. Список выбора идентифицируется параметром type. Функция возвращает true если слово было успешно удалено.
[virtual] QList<QVirtualKeyboardSelectionListModel::Type> QVirtualKeyboardAbstractInputMethod::selectionLists()
Возвращает список списков выбора, используемых этим методом ввода.
Этот метод вызывается движком ввода при активации метода ввода и каждый раз, когда обновляются подсказки метода ввода. Метод ввода может зарезервировать списки выбора, вернув желаемые типы списков выбора.
Метод ввода может запросить у движка ввода обновить списки выбора в любое время, излучая сигнал selectionListsChanged(). Этот сигнал вызовет этот метод, позволяя методу ввода обновить типы списков выбора.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()
Метод ввода излучает этот сигнал, когда типы списков выбора изменились. Этот сигнал вызовет метод selectionLists(), позволяя методу ввода обновить типы списков выбора.
Эта функция была введена в QtQuick.VirtualKeyboard 2.2.
[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)
Устанавливает inputMode и locale для этого метода ввода. Возвращает true в случае успеха.
[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)
Обновляет textCase для этого метода ввода. Метод возвращает true в случае успеха.
[virtual] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)
Этот метод вызывается при запуске взаимодействия трассировки со специфицированным режимом patternRecognitionMode. Трассировка уникально идентифицируется параметром traceId. traceCaptureDeviceInfo предоставляет информацию о целевом устройстве, а traceScreenInfo — информацию о контексте экрана.
Если метод ввода принимает событие и хочет захватить трассировку, он должен вернуть новый объект QVirtualKeyboardTrace. Этот объект должен оставаться валидным до вызова метода traceEnd(). Если QVirtualKeyboardTrace отображается на экране, он остается там до удаления объекта QVirtualKeyboardTrace.
Эта функция была введена в QtQuick.VirtualKeyboard 2.0.
[virtual] bool QVirtualKeyboardAbstractInputMethod::traceEnd(QVirtualKeyboardTrace *trace)
Этот метод вызывается при завершении взаимодействия трассировки. Метод ввода должен удалить объект trace в какой-то момент после вызова этой функции. См. Trace API для методов ввода, как получить собранные данные.
Метод возвращает true если взаимодействие трассировки принято.
Эта функция была введена в QtQuick.VirtualKeyboard 2.0.
[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()
Этот метод вызывается движком ввода, когда требуется обновить метод ввода. Метод ввода должен закрыть текущий предварительный текст и восстановить своё внутреннее состояние по умолчанию.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qvirtualkeyboardabstractinputmethod.html