Класс QAbstractProxyModel

Класс QAbstractProxyModel предоставляет базовый класс для прокси-моделей элементов, которые могут выполнять сортировку, фильтрацию или другие задачи обработки данных. Подробнее...

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

Свойства

• sourceModel : QAbstractItemModel*

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

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

Сигналы

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

Этот класс определяет стандартный интерфейс, который должны использовать модели-прокси для корректной работы с другими компонентами модели/представления. Он не должен создаваться напрямую.

Все стандартные модели-прокси наследуются от класса QAbstractProxyModel. Если вам нужно создать новый класс модели-прокси, обычно лучше унаследовать от существующего класса, который предоставляет поведение, наиболее близкое к тому, которое вы хотите.

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

Для наследования от QAbstractProxyModel вам необходимо реализовать mapFromSource() и mapToSource(). Функции mapSelectionFromSource() и mapSelectionToSource() необходимо переопределять только в том случае, если вам нужно поведение, отличное от стандартного.

Примечание: Если источниковая модель удалена или не указана, модель-прокси работает с пустой замещающей моделью.

См. также QSortFilterProxyModel, QAbstractItemModel и Программирование Модель/Представление.

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

QAbstractProxyModel::QAbstractProxyModel(QObject *parent = nullptr)

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

[virtual] QAbstractProxyModel::~QAbstractProxyModel()

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

[override virtual] QModelIndex QAbstractProxyModel::buddy(const QModelIndex &index) const

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

[override virtual, since 5.4] bool QAbstractProxyModel::canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const

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

Функция была добавлена в Qt 5.4.

[override virtual] bool QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const

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

[override virtual, since 6.0] bool QAbstractProxyModel::clearItemData(const QModelIndex &index)

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

Функция была добавлена в Qt 6.0.

[override virtual] QVariant QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role = Qt::DisplayRole) const

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

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

[override virtual, since 5.4] bool QAbstractProxyModel::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).

Функция была добавлена в Qt 5.4.

[override virtual] void QAbstractProxyModel::fetchMore(const QModelIndex &parent)

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

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

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

[override virtual] bool QAbstractProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

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

[override virtual] QVariant QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

Переопределяет: QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

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

[override virtual] QMap<int, QVariant> QAbstractProxyModel::itemData(const QModelIndex &proxyIndex) const

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

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

[pure virtual] QModelIndex QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const

Переопределите эту функцию, чтобы вернуть индекс модели в модели-прокси, соответствующий sourceIndex из исходной модели.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

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

[virtual] QItemSelection QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const

Возвращает выделение прокси, отображённое из указанного sourceSelection.

Переопределите этот метод, чтобы отобразить выделения источника в выделения прокси.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[virtual] QItemSelection QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const

Возвращает выделение источника, отображённое из указанного proxySelection.

Переопределите этот метод, чтобы отобразить выделения прокси в выделения источника.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[pure virtual] QModelIndex QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const

Переопределите эту функцию, чтобы вернуть индекс модели в исходной модели, соответствующий proxyIndex в модели-прокси.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

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

[override virtual] QMimeData *QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const

Переопределяет: QAbstractItemModel::mimeData(const QModelIndexList &indexes) const.

[override virtual] QStringList QAbstractProxyModel::mimeTypes() const

Переопределяет: QAbstractItemModel::mimeTypes() const.

[override virtual] void QAbstractProxyModel::revert()

Переопределяет: QAbstractItemModel::revert().

[override virtual] QHash<int, QByteArray> QAbstractProxyModel::roleNames() const

Переопределяет: QAbstractItemModel::roleNames() const.

[override virtual] bool QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

Переопределяет: QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).

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

[override virtual] bool QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

Реализует: QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

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

[override virtual] bool QAbstractProxyModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)

Реализует: QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).

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

[virtual] void QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)

Устанавливает указанный sourceModel для обработки прокси-моделью.

Подклассы должны вызывать beginResetModel() в начале метода, разорвать соединение со старой моделью, вызвать этот метод, подключиться к новой модели и вызвать endResetModel().

Примечание: Функция-сеттер для свойства sourceModel.

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

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

Реализует: QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const.

[override virtual] void QAbstractProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

Реализует: QAbstractItemModel::sort(int column, Qt::SortOrder order).

QAbstractItemModel *QAbstractProxyModel::sourceModel() const

Возвращает модель, содержащую данные, доступные через прокси-модель.

Примечание: Функция-геттер для свойства sourceModel.

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

[override virtual] QSize QAbstractProxyModel::span(const QModelIndex &index) const

Реализует: QAbstractItemModel::span(const QModelIndex &index) const.

[override virtual] bool QAbstractProxyModel::submit()

Реализует: QAbstractItemModel::submit().

[override virtual] Qt::DropActions QAbstractProxyModel::supportedDragActions() const

Реализует: QAbstractItemModel::supportedDragActions() const.

[override virtual] Qt::DropActions QAbstractProxyModel::supportedDropActions() const

Реализует: QAbstractItemModel::supportedDropActions() const.