Класс 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) |
Открытые слоты
| virtual void | reset() |
| virtual void | update() |
Сигналы
| void | selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index) |
| void | selectionListChanged(QVirtualKeyboardSelectionListModel::Type type) |
| void | selectionListsChanged() |
Подробное описание
Используйте этот класс, если хотите реализовать пользовательский метод ввода, используя языки C/C++.
Документация по функциям-членам
QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)
Создает метод ввода с parent.
[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()
Этот метод вызывается движком ввода, когда метод ввода необходимо сбросить. Метод ввода должен сбросить только свое внутреннее состояние. Основное отличие от метода update() заключается в том, что reset() изменяет только состояние метода ввода, т.е. он не должен изменять контекст ввода.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)
Метод ввода излучает этот сигнал, когда текущий индекс изменился в списке выбора, идентифицируемом по type.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)
Метод ввода излучает этот сигнал, когда содержимое списка выбора изменилось. Параметр type указывает, какой список выбора изменился.
[signal] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()
Метод ввода излучает этот сигнал, когда типы списков выбора изменились. Этот сигнал вызовет вызов метода selectionLists(), что позволит методу ввода обновить типы списков выбора.
Эта функция была добавлена в QtQuick.VirtualKeyboard 2.2.
[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()
Этот метод вызывается движком ввода, когда метод ввода необходимо обновить. Метод ввода должен закрыть текущий текст предварительного редактирования и восстановить свое внутреннее состояние по умолчанию.
[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] Список<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)
Возвращает список режимов ввода для locale.
[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
Этот метод предназначен для обработки событий нажатия клавиш, сгенерированных движком ввода.
Параметр key указывает код клавиши, которую необходимо обработать. Код клавиши не различает заглавные и строчные буквы. Параметр text содержит текстовое значение Unicode для клавиши. Параметр modifiers содержит модификаторы клавиш, которые применяются к клавише.
Этот метод возвращает true если событие нажатия клавиши было успешно обработано. Если возвращаемое значение false, событие нажатия клавиши перенаправляется на метод ввода по умолчанию для дальнейшей обработки.
[virtual] Список<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] 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(). Этот сигнал запустит вызов этого метода, позволяя методу ввода обновить типы списков выбора.
[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 в какой-то момент после вызова этой функции. См. API отслеживания для методов ввода, как получить собранные данные.
Метод возвращает true если взаимодействие с отслеживанием принято.
Этот метод был добавлен в QtQuick.VirtualKeyboard 2.0.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qvirtualkeyboardabstractinputmethod.html