Класс QAbstractProxyModel

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

Этот класс был представлен в Qt 4.1.

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

Свойства

• sourceModel : QAbstractItemModel*

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

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

Сигналы

Защищённые слоты

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

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

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

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

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

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

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

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

QAbstractProxyModel::QAbstractProxyModel(QObject *parent = nullptr)

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

[protected slot] void QAbstractProxyModel::resetInternalData()

Очищает roleNames этой модели-прокси.

[virtual] QAbstractProxyModel::~QAbstractProxyModel()

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

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

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

[override virtual] 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] QVariant QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role = Qt::DisplayRole) const

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

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

[override virtual] 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] 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.