Класс QAbstractListModel

Класс QAbstractListModel предоставляет абстрактную модель, которую можно наследовать для создания одномерных моделей списков. Подробнее...

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

Открытые функции

Переопределённые открытые функции

Подробное описание

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

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

Простые модели можно создавать, наследуя от этого класса и реализуя минимальное количество необходимых функций. Например, мы могли бы реализовать простую только для чтения модель на основе QStringList, которая предоставляет список строк виджету QListView. В таком случае нам нужно только реализовать функцию rowCount() для возвращения количества элементов в списке и функцию data() для извлечения элементов из списка.

Поскольку модель представляет одномерную структуру, функция rowCount() возвращает общее количество элементов в модели. Функция columnCount() реализована для совместимости со всеми типами представлений, но по умолчанию сообщает представлениям, что модель содержит только один столбец.

Наследование

При наследовании от QAbstractListModel необходимо предоставить реализации функций rowCount() и data(). Хорошо спроектированные модели также предоставляют реализацию headerData().

Если ваша модель используется в QML и требует ролей, отличных от стандартных, предоставляемых функцией roleNames(), необходимо переопределить её.

Для редактируемых моделей списков необходимо также предоставить реализацию setData() и реализовать функцию flags(), чтобы она возвращала значение, содержащее Qt::ItemIsEditable.

Обратите внимание, что QAbstractListModel предоставляет реализацию по умолчанию для columnCount(), которая сообщает представлениям, что в этой модели есть только один столбец элементов.

Модели, предоставляющие интерфейсы для изменяемых списков данных, могут предоставить реализации insertRows() и removeRows(). При реализации этих функций важно вызывать соответствующие функции, чтобы все подключённые представления были осведомлены обо всех изменениях:

• Реализация insertRows() должна вызывать beginInsertRows() перед вставкой новых строк в структуру данных и должна вызывать endInsertRows() непосредственно после.
• Реализация removeRows() должна вызывать beginRemoveRows() перед удалением строк из структуры данных и должна вызывать endRemoveRows() непосредственно после.

Примечание: Некоторые общие рекомендации по наследованию от моделей приведены в Справочнике по наследованию от моделей.

См. также Классы моделей, Справочник по наследованию от моделей, QAbstractItemView, QAbstractTableModel и Пример с виджетами представлений элементов.

Документация по функциям-членам

QAbstractListModel::QAbstractListModel(QObject *parent = nullptr)

Создаёт абстрактную модель списка с указанным parent.

[virtual] QAbstractListModel::~QAbstractListModel()

Уничтожает абстрактную модель списка.

[override virtual] bool QAbstractListModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

Переопределяет: QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

[override virtual] Qt::ItemFlags QAbstractListModel::flags(const QModelIndex &index) const

Переопределяет: QAbstractItemModel::flags(const QModelIndex &index) const.

[override virtual] QModelIndex QAbstractListModel::index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const

Переопределяет: QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

Возвращает индекс данных в row и column с parent.

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

[override virtual] QModelIndex QAbstractListModel::sibling(int row, int column, const QModelIndex &idx) const

Переопределяет: QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const.