Класс QAbstractListModel

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

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

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

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

• 40 открытых функций унаследовано от QAbstractItemModel
• 32 открытых функций унаследовано от QObject

Статические открытые члены

• 10 статических открытых членов унаследовано от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 2 открытых слота унаследовано от QAbstractItemModel
• 1 открытый слот унаследовано от QObject
• 18 сигналов унаследовано от QAbstractItemModel
• 2 сигнала унаследовано от QObject
• 19 защищённых функций унаследовано от QAbstractItemModel
• 9 защищённых функций унаследовано от QObject
• 1 защищённый слот унаследовано от QAbstractItemModel

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

Класс 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.

~QAbstractListModel::~QAbstractListModel()

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

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

Переопределено из QAbstractItemModel::dropMimeData().

Qt::ItemFlags QAbstractListModel::flags(const QModelIndex &index) const

Переопределено из QAbstractItemModel::flags().

QModelIndex QAbstractListModel::index(int row, int column = 0, const QModelIndex &parent = ...) const

Переопределено из QAbstractItemModel::index().

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

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

QModelIndex QAbstractListModel::sibling(int row, int column, const QModelIndex &idx) const

Переопределено из QAbstractItemModel::sibling().