QAbstractProxyModel Class
La clase `QAbstractProxyModel` proporciona una clase base para modelos de elementos proxy capaces de realizar tareas de ordenación, filtrado u otras tareas de procesamiento de datos. Más información...
| Encabezado: | #include <QAbstractProxyModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QAbstractItemModel |
| Heredado por: | QIdentityProxyModel, ` QSortFilterProxyModel` y QTransposeProxyModel |
Propiedades
- sourceModel : QAbstractItemModel*
Funciones públicas
| QAbstractProxyModel(QObject *parent = nullptr) | |
| virtual | ~QAbstractProxyModel() |
| QBindable<QAbstractItemModel *> | bindableSourceModel() |
| virtual QModelIndex | mapFromSource(const QModelIndex &sourceIndex) const = 0 |
| virtual QItemSelection | mapSelectionFromSource(const QItemSelection &sourceSelection) const |
| virtual QItemSelection | mapSelectionToSource(const QItemSelection &proxySelection) const |
| virtual QModelIndex | mapToSource(const QModelIndex &proxyIndex) const = 0 |
| virtual void | setSourceModel(QAbstractItemModel *sourceModel) |
| QAbstractItemModel * | sourceModel() const |
Funciones públicas reimplementadas
| virtual QModelIndex | buddy(const QModelIndex &index) const override |
| virtual bool | canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const override |
| virtual bool | canFetchMore(const QModelIndex &parent) const override |
(since 6.0) virtual bool | clearItemData(const QModelIndex &index) override |
| virtual QVariant | data(const QModelIndex &proxyIndex, int role = Qt::DisplayRole) const override |
| virtual bool | dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override |
| virtual void | fetchMore(const QModelIndex &parent) override |
| virtual Qt::ItemFlags | flags(const QModelIndex &index) const override |
| virtual bool | hasChildren(const QModelIndex &parent = QModelIndex()) const override |
| virtual QVariant | headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override |
| virtual QMap<int, QVariant> | itemData(const QModelIndex &proxyIndex) const override |
| virtual QMimeData * | mimeData(const QModelIndexList &indexes) const override |
| virtual QStringList | mimeTypes() const override |
| virtual void | revert() override |
| virtual QHash<int, QByteArray> | roleNames() const override |
| virtual bool | setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override |
| virtual bool | setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole) override |
| virtual bool | setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles) override |
| virtual QModelIndex | sibling(int row, int column, const QModelIndex &idx) const override |
| virtual void | sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override |
| virtual QSize | span(const QModelIndex &index) const override |
| virtual bool | submit() override |
| virtual Qt::DropActions | supportedDragActions() const override |
| virtual Qt::DropActions | supportedDropActions() const override |
Señales
| void | sourceModelChanged() |
Funciones protegidas
(since 6.2) QModelIndex | createSourceIndex(int row, int col, void *internalPtr) const |
Descripción detallada
Esta clase define la interfaz estándar que deben utilizar los modelos proxy para poder interoperar correctamente con otros componentes de modelo/vista. No está pensada para ser instanciada directamente.
Todos los modelos proxy estándar derivan de la clase `QAbstractProxyModel`. Si necesitas crear una nueva clase de modelo proxy, suele ser mejor crear una subclase de una clase existente que ofrezca un comportamiento lo más parecido posible al que deseas proporcionar.
Los modelos proxy que filtran u ordenan elementos de datos de un modelo de origen deben crearse utilizando o subclasificando QSortFilterProxyModel.
Para crear una subclase de `QAbstractProxyModel`, es necesario implementar ` mapFromSource()` y ` mapToSource()`. Las funciones ` mapSelectionFromSource()` y ` mapSelectionToSource()` solo deben reimplementarse si se necesita un comportamiento diferente al predeterminado.
Nota: Si se elimina el modelo de origen o no se especifica ninguno, el modelo proxy opera sobre un modelo marcador de posición vacío.
Véase también QSortFilterProxyModel, QAbstractItemModel y Programación de modelos y vistas.
Documentación de propiedades
[bindable] sourceModel : QAbstractItemModel*
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el modelo de origen de este modelo proxy.
Funciones de acceso:
| QAbstractItemModel * | sourceModel() const |
| virtual void | setSourceModel(QAbstractItemModel *sourceModel) |
Señal de notificador:
| void | sourceModelChanged() | [see note below] |
Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.
Documentación de las funciones de miembro
[explicit] QAbstractProxyModel::QAbstractProxyModel(QObject *parent = nullptr)
Crea un modelo proxy a partir del parent facilitado.
[virtual noexcept] QAbstractProxyModel::~QAbstractProxyModel()
Destruye el modelo de proxy.
[override virtual] QModelIndex QAbstractProxyModel::buddy(const QModelIndex &index) const
Reimplementa: ` 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
Reimplementa: QAbstractItemModel::canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const.
[override virtual] bool QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const
Reimplementa: ` QAbstractItemModel::canFetchMore(const QModelIndex &parent) const`.
[override virtual, since 6.0] bool QAbstractProxyModel::clearItemData(const QModelIndex &index)
Reimplementa: ` QAbstractItemModel::clearItemData(const QModelIndex &index)`.
Esta función se introdujo en Qt 6.0.
[protected, since 6.2] QModelIndex QAbstractProxyModel::createSourceIndex(int row, int col, void *internalPtr) const
Equivale a llamar a `createIndex` en el modelo de origen.
Este método resulta útil si el modelo proxy desea mantener la relación padre-hijo de los elementos del modelo de origen. Al reimplementar ` mapToSource()`, puedes llamar a este método para crear un índice para la fila ` row ` y la columna ` col ` del modelo de origen.
Un uso típico sería guardar el puntero interno procedente del modelo de origen en el índice del proxy al reimplementar ` mapFromSource()` y utilizar ese mismo puntero interno como ` internalPtr ` para recuperar el índice de origen original al reimplementar ` mapToSource()`.
Esta función se introdujo en Qt 6.2.
[override virtual] QVariant QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractItemModel::data(const QModelIndex &index, int role) const`.
Véase también setData().
[override virtual] bool QAbstractProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)
Reimplementa: QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).
[override virtual] void QAbstractProxyModel::fetchMore(const QModelIndex &parent)
Reimplementa: ` QAbstractItemModel::fetchMore(const QModelIndex &parent)`.
[override virtual] Qt::ItemFlags QAbstractProxyModel::flags(const QModelIndex &index) const
Reimplementa: ` QAbstractItemModel::flags(const QModelIndex &index) const`.
[override virtual] bool QAbstractProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::hasChildren(const QModelIndex &parent) const`.
[override virtual] QVariant QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const`.
Véase también setHeaderData().
[override virtual] QMap<int, QVariant> QAbstractProxyModel::itemData(const QModelIndex &proxyIndex) const
Reimplementa: ` QAbstractItemModel::itemData(const QModelIndex &index) const`.
Véase también setItemData().
[pure virtual invokable] QModelIndex QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const
Reimplementa esta función para que devuelva el índice del modelo en el modelo proxy que se corresponde con el « sourceIndex » del modelo de origen.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también mapToSource().
[virtual invokable] QItemSelection QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const
Devuelve una selección de proxy asignada a partir de la selección de origen especificada en ` sourceSelection`.
Reimplementa este método para asignar selecciones de origen a selecciones proxy.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[virtual invokable] QItemSelection QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const
Devuelve una selección de origen asignada a partir de la selección de proxy especificada ( proxySelection).
Reimplementa este método para asignar selecciones proxy a selecciones de origen.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[pure virtual invokable] QModelIndex QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const
Reimplementa esta función para que devuelva el índice del modelo en el modelo de origen que se corresponda con el « proxyIndex » del modelo proxy.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también mapFromSource().
[override virtual] QMimeData *QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const
Reimplementa: ` QAbstractItemModel::mimeData(const QModelIndexList &indexes) const`.
[override virtual] QStringList QAbstractProxyModel::mimeTypes() const
Reimplementa: ` QAbstractItemModel::mimeTypes()` const.
[override virtual] void QAbstractProxyModel::revert()
Reimplementa: QAbstractItemModel::revert().
[override virtual] QHash<int, QByteArray> QAbstractProxyModel::roleNames() const
Reimplementa: ` QAbstractItemModel::roleNames()` const.
[override virtual] bool QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)
Reimplementa: QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).
Véase también data().
[override virtual] bool QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)
Reimplementa: QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).
Véase también headerData().
[override virtual] bool QAbstractProxyModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)
Reimplementa: QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).
Véase también itemData().
[virtual] void QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)
Establece el archivo « sourceModel » indicado para que sea procesado por el modelo proxy.
Las subclases deben llamar a ` beginResetModel()` al inicio del método, desconectarse del modelo anterior, llamar a este método, conectarse al nuevo modelo y llamar a ` endResetModel()`.
Nota: Funciónsetter para la propiedad sourceModel.
Véase también sourceModel().
[override virtual] QModelIndex QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const
Reimplementa: ` QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const`.
[override virtual] void QAbstractProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)
Reimplementa: ` QAbstractItemModel::sort` (`int column`, `Qt::SortOrder order`).
QAbstractItemModel *QAbstractProxyModel::sourceModel() const
Devuelve el modelo que contiene los datos disponibles a través del modelo proxy.
Nota: Funcióngetter para la propiedad sourceModel.
Véase también setSourceModel().
[override virtual] QSize QAbstractProxyModel::span(const QModelIndex &index) const
Reimplementa: ` QAbstractItemModel::span(const QModelIndex &index) const`.
[override virtual] bool QAbstractProxyModel::submit()
Reimplementa: QAbstractItemModel::submit().
[override virtual] Qt::DropActions QAbstractProxyModel::supportedDragActions() const
Reimplementa: QAbstractItemModel::supportedDragActions() const.
[override virtual] Qt::DropActions QAbstractProxyModel::supportedDropActions() const
Reimplementa: ` QAbstractItemModel::supportedDropActions()` const.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.