Модель списка выбора SelectionListModel QML
Обеспечивает модель данных для списков выбора. Подробнее...
| Заявление импорта: | import QtQuick.VirtualKeyboard 2.15 |
| Создаёт экземпляр: | QVirtualKeyboardSelectionListModel |
Сигналы
- void activeItemChanged(int index)
- void itemSelected(int index)
Методы
- void removeItem(int index)
- void selectItem(int index)
Подробное описание
SelectionListModel — это модель данных для предложений слов, предоставляемых методом ввода.
Экземпляр SelectionListModel не может быть создан напрямую. Вместо этого InputEngine управляет экземплярами и предоставляет доступ к модели через свойство InputEngine::wordCandidateListModel.
Модель предоставляет следующие роли данных для делегата списка:
-
displayТекст отображения для элемента. -
wordCompletionLengthДлина завершения слова для элемента. -
dictionaryTypeТип словаря слова, см. QVirtualKeyboardSelectionListModel::DictionaryType. -
canRemoveSuggestionБулево значение, указывающее, можно ли удалить слово из словаря.
Сигнал activeItemChanged указывает, какой элемент в данный момент выделен методом ввода. Виджет должен реагировать на этот сигнал, выделяя соответствующий элемент в списке.
Выбор пользователя обрабатывается методом selectItem(). Виджет должен вызывать этот метод, когда пользователь выбирает элемент из списка.
Документация по сигналам
void activeItemChanged(int index)
Этот сигнал излучается, когда активный элемент в списке изменяется. Пользовательский интерфейс должен реагировать на этот сигнал, выделяя элемент с индексом index в списке.
Примечание: Соответствующий обработчик — onActiveItemChanged.
void itemSelected(int index)
Этот сигнал излучается, когда пользователь выбирает элемент с индексом index.
Примечание: Соответствующий обработчик — onItemSelected.
Документация по методам
void removeItem(int index)
Этот метод должен вызываться, когда пользователь удаляет элемент с позицией index из списка. Удаление передаётся методу ввода для дальнейшей обработки.
void selectItem(int index)
Этот метод должен вызываться, когда пользователь выбирает элемент с позицией index из списка. Выбор передаётся методу ввода для дальнейшей обработки.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtquick-virtualkeyboard-selectionlistmodel.html