QIdentityProxyModel Class
La clase `QIdentityProxyModel` actúa como proxy de su modelo de origen sin modificarlo. Más información...
| Encabezado: | #include <QIdentityProxyModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QAbstractProxyModel |
Funciones públicas
| QIdentityProxyModel(QObject *parent = nullptr) | |
| virtual | ~QIdentityProxyModel() |
(since 6.8) bool | handleSourceDataChanges() const |
(since 6.8) bool | handleSourceLayoutChanges() const |
Funciones públicas reimplementadas
| virtual int | columnCount(const QModelIndex &parent = QModelIndex()) const override |
| virtual bool | dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override |
| virtual QVariant | headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override |
| virtual QModelIndex | index(int row, int column, const QModelIndex &parent = QModelIndex()) const override |
| virtual bool | insertColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual bool | insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual QModelIndex | mapFromSource(const QModelIndex &sourceIndex) const override |
| virtual QItemSelection | mapSelectionFromSource(const QItemSelection &selection) const override |
| virtual QItemSelection | mapSelectionToSource(const QItemSelection &selection) const override |
| virtual QModelIndex | mapToSource(const QModelIndex &proxyIndex) const override |
| virtual QModelIndexList | match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const override |
| virtual bool | moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild) override |
| virtual bool | moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild) override |
| virtual QModelIndex | parent(const QModelIndex &child) const override |
| virtual bool | removeColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual bool | removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual int | rowCount(const QModelIndex &parent = QModelIndex()) const override |
| virtual void | setSourceModel(QAbstractItemModel *newSourceModel) override |
| virtual QModelIndex | sibling(int row, int column, const QModelIndex &idx) const override |
Funciones protegidas
(since 6.8) void | setHandleSourceDataChanges(bool b) |
(since 6.8) void | setHandleSourceLayoutChanges(bool b) |
Descripción detallada
QIdentityProxyModel se puede utilizar para transmitir la estructura de un modelo de origen tal cual, sin ordenación, filtrado ni ninguna otra transformación. Este concepto es similar al de una matriz identidad, donde A.I = A.
Dado que no realiza ordenación ni filtrado, esta clase es la más adecuada para modelos proxy que transforman la función « data()» del modelo de origen. Por ejemplo, se podría crear un modelo proxy para definir la fuente utilizada, el color de fondo, la información sobre herramientas, etc. Esto elimina la necesidad de implementar todo el manejo de datos en la misma clase que crea la estructura del modelo, y también puede utilizarse para crear componentes reutilizables.
Además, ofrece una forma de modificar los datos en el caso de que el modelo de origen lo proporcione un tercero y no se pueda modificar.
class DateFormatProxyModel : public QIdentityProxyModel
{
// ...
void setDateFormatString(const QString &formatString)
{
m_formatString = formatString;
}
QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override
{
if (role != Qt::DisplayRole)
return QIdentityProxyModel::data(index, role);
const QModelIndex sourceIndex = mapToSource(index);
const QDateTime dateTime = sourceModel()->data(sourceIndex, SourceClass::DateRole).toDateTime();
return dateTime.toString(m_formatString);
}
QMap<int, QVariant> itemData(const QModelIndex &proxyIndex) const override
{
QMap<int, QVariant> map = QIdentityProxyModel::itemData(proxyIndex);
map[Qt::DisplayRole] = data(proxyIndex);
return map;
}
private:
QString m_formatString;
};Véase también QAbstractProxyModel, Programación Modelo/Vista y QAbstractItemModel.
Documentación de las funciones de miembro
[explicit] QIdentityProxyModel::QIdentityProxyModel(QObject *parent = nullptr)
Crea un modelo de identidad a partir de la dirección parent.
[virtual noexcept] QIdentityProxyModel::~QIdentityProxyModel()
Elimina este modelo de identidad.
[override virtual] int QIdentityProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::columnCount(const QModelIndex &parent) const`.
[override virtual] bool QIdentityProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)
Reimplementa: QAbstractProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).
[since 6.8] bool QIdentityProxyModel::handleSourceDataChanges() const
Devuelve ` true ` si este modelo proxy gestiona los cambios en los datos del modelo de origen; en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.8.
Véase también setHandleSourceDataChanges().
[since 6.8] bool QIdentityProxyModel::handleSourceLayoutChanges() const
Devuelve ` true ` si este modelo proxy gestiona los cambios en el diseño del modelo de origen; en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.8.
Véase también setHandleSourceLayoutChanges().
[override virtual] QVariant QIdentityProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const`.
[override virtual] QModelIndex QIdentityProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::index` (int row, int column, const QModelIndex &parent) const.
[override virtual] bool QIdentityProxyModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: ` QAbstractItemModel::insertColumns` (int column, int count, const QModelIndex &parent).
[override virtual] bool QIdentityProxyModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).
[override virtual] QModelIndex QIdentityProxyModel::mapFromSource(const QModelIndex &sourceIndex) const
Reimplementa: ` QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const`.
[override virtual] QItemSelection QIdentityProxyModel::mapSelectionFromSource(const QItemSelection &selection) const
Reimplementa: ` QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const`.
[override virtual] QItemSelection QIdentityProxyModel::mapSelectionToSource(const QItemSelection &selection) const
Reimplementa: ` QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const`.
[override virtual] QModelIndex QIdentityProxyModel::mapToSource(const QModelIndex &proxyIndex) const
Reimplementa: QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.
[override virtual] QModelIndexList QIdentityProxyModel::match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const
Reimplementa: ` QAbstractItemModel::match(const QModelIndex &start, int role, const QVariant &value, int hits, Qt::MatchFlags flags) const`.
[override virtual] bool QIdentityProxyModel::moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild)
Reimplementa: ` QAbstractItemModel::moveColumns` (const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild).
[override virtual] bool QIdentityProxyModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)
Reimplementa: QAbstractItemModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild).
[override virtual] QModelIndex QIdentityProxyModel::parent(const QModelIndex &child) const
Reimplementa: ` QAbstractItemModel::parent(const QModelIndex &index) const`.
[override virtual] bool QIdentityProxyModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: ` QAbstractItemModel::removeColumns` (int column, int count, const QModelIndex &parent).
[override virtual] bool QIdentityProxyModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).
[override virtual] int QIdentityProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.
[protected, since 6.8] void QIdentityProxyModel::setHandleSourceDataChanges(bool b)
Si b es true, este modelo proxy gestionará los cambios en los datos del modelo de origen (conectándose a la señal QAbstractItemModel::dataChanged ).
Por defecto, este modelo proxy gestiona los cambios en los datos del modelo de origen.
En las subclases de ` QIdentityProxyModel`, puede resultar útil establecer este valor en ` false ` si necesitas gestionar de forma específica los cambios en los datos del modelo fuente.
Nota: La llamada a este método solo surtirá efecto tras llamar a ` setSourceModel()` ().
Esta función se introdujo en Qt 6.8.
Véase también ` handleSourceDataChanges()`.
[protected, since 6.8] void QIdentityProxyModel::setHandleSourceLayoutChanges(bool b)
Si b es true, este modelo proxy gestionará los cambios en la disposición del modelo de origen (conectándose a las señales QAbstractItemModel::layoutAboutToBeChanged y QAbstractItemModel::layoutChanged ).
Por defecto, este modelo proxy se encarga de gestionar los cambios de diseño del modelo fuente.
En las subclases de ` QIdentityProxyModel`, puede resultar útil establecer este valor en ` false ` si necesitas gestionar de forma específica los cambios en el diseño del modelo fuente.
Nota: La llamada a este método solo surtirá efecto tras llamar a ` setSourceModel()`.
Esta función se introdujo en Qt 6.8.
Véase también ` handleSourceLayoutChanges()`.
[override virtual] void QIdentityProxyModel::setSourceModel(QAbstractItemModel *newSourceModel)
Reimplementa: ` QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)`.
[override virtual] QModelIndex QIdentityProxyModel::sibling(int row, int column, const QModelIndex &idx) const
Reimplementa: ` QAbstractProxyModel::sibling` (int row, int column, const QModelIndex &idx) 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.