En esta página

QConcatenateTablesProxyModel Class

La clase `QConcatenateTablesProxyModel` actúa como proxy de varios modelos de origen, concatenando sus filas. Más información...

Encabezado: #include <QConcatenateTablesProxyModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QAbstractItemModel

Funciones públicas

QConcatenateTablesProxyModel(QObject *parent = nullptr)
virtual ~QConcatenateTablesProxyModel()
void addSourceModel(QAbstractItemModel *sourceModel)
QModelIndex mapFromSource(const QModelIndex &sourceIndex) const
QModelIndex mapToSource(const QModelIndex &proxyIndex) const
void removeSourceModel(QAbstractItemModel *sourceModel)
QList<QAbstractItemModel *> sourceModels() const

Funciones públicas reimplementadas

virtual bool canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const override
virtual int columnCount(const QModelIndex &parent = QModelIndex()) const override
virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override
virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override
virtual Qt::ItemFlags flags(const QModelIndex &index) const 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 QMap<int, QVariant> itemData(const QModelIndex &proxyIndex) const override
virtual QMimeData *mimeData(const QModelIndexList &indexes) const override
virtual QStringList mimeTypes() const override
virtual QModelIndex parent(const QModelIndex &index) const override
(since 6.9.0) virtual QHash<int, QByteArray> roleNames() const override
virtual int rowCount(const QModelIndex &parent = QModelIndex()) const override
virtual bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override
virtual bool setItemData(const QModelIndex &proxyIndex, const QMap<int, QVariant> &roles) override
virtual QSize span(const QModelIndex &index) const override

Descripción detallada

QConcatenateTablesProxyModel toma varios modelos de origen y concatena sus filas.

En otras palabras, el proxy tendrá todas las filas del primer modelo de origen, seguidas de todas las filas del segundo modelo de origen, y así sucesivamente.

Si los modelos de origen no tienen el mismo número de columnas, el proxy solo tendrá tantas columnas como el modelo de origen con el menor número de columnas. Las columnas adicionales de otros modelos de origen simplemente se ignorarán.

Los modelos de origen se pueden añadir y eliminar en tiempo de ejecución, y el número de columnas se ajusta en consecuencia.

Este proxy no hereda de « QAbstractProxyModel » porque utiliza varios modelos de origen, en lugar de uno solo.

Solo se admiten modelos planos (listas y tablas); los modelos de árbol no son compatibles.

Véase también QAbstractProxyModel, Programación de modelos y vistas, QIdentityProxyModel y QAbstractItemModel.

Documentación de las funciones de miembro

[explicit] QConcatenateTablesProxyModel::QConcatenateTablesProxyModel(QObject *parent = nullptr)

Crea un modelo proxy de concatenación de filas con el parent proporcionado.

[virtual noexcept] QConcatenateTablesProxyModel::~QConcatenateTablesProxyModel()

Elimina este modelo proxy.

void QConcatenateTablesProxyModel::addSourceModel(QAbstractItemModel *sourceModel)

Añade un modelo de origen sourceModel, debajo de todos los modelos de origen añadidos anteriormente.

La propiedad de sourceModel no se ve afectada por esta acción.

No se puede añadir el mismo modelo de origen más de una vez.

[override virtual] bool QConcatenateTablesProxyModel::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] int QConcatenateTablesProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const

Reimplementa: ` QAbstractItemModel::columnCount(const QModelIndex &parent) const`.

Este método devuelve el número de columnas del modelo de origen que tiene el menor número de columnas.

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

Reimplementa: ` QAbstractItemModel::data(const QModelIndex &index, int role) const`.

Véase también setData().

[override virtual] bool QConcatenateTablesProxyModel::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).

QConcatenateTablesProxyModel Gestiona el arrastre de elementos sobre un elemento, entre elementos y después del último elemento. En todos los casos, la llamada se reenvía al modelo fuente subyacente. Al arrastrar sobre un elemento, se llama al modelo fuente de dicho elemento. Al arrastrar entre elementos, se llama al modelo fuente situado inmediatamente debajo de la posición de arrastre. Al arrastrar después del último elemento, se llama al último modelo fuente.

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

Reimplementa: QAbstractItemModel::flags(const QModelIndex &index) const.

Devuelve los indicadores correspondientes al índice dado. Si el ` index ` es válido, los indicadores proceden del modelo de origen de este ` index`. Si el ` index ` no es válido (como ocurre, por ejemplo, al determinar si se permite soltar un elemento en un área vacía de la vista), se devuelven los indicadores del primer modelo.

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

Reimplementa: ` QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const`.

Este método devuelve los datos de la cabecera horizontal del primer modelo de origen y los datos de la cabecera vertical del modelo de origen correspondiente a cada fila.

[override virtual] QModelIndex QConcatenateTablesProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

Reimplementa: ` QAbstractItemModel::index` (int row, int column, const QModelIndex &parent) const.

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

Reimplementa: QAbstractItemModel::itemData(const QModelIndex &index) const.

Véase también ` setItemData()`.

[invokable] QModelIndex QConcatenateTablesProxyModel::mapFromSource(const QModelIndex &sourceIndex) const

Devuelve el índice de proxy para un ` sourceIndex` dado, que puede proceder de cualquiera de los modelos de origen.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QModelIndex QConcatenateTablesProxyModel::mapToSource(const QModelIndex &proxyIndex) const

Devuelve el índice de origen de un ` proxyIndex` dado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

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

Reimplementa: ` QAbstractItemModel::mimeData(const QModelIndexList &indexes) const`.

La llamada se reenvía al modelo de origen del primer índice de la lista de indexes.

Importante: ten en cuenta que este proxy solo admite arrastrar una única fila. Se producirá un error si se invoca con índices de varias filas, ya que este modelo proxy no puede implementar de forma genérica el arrastre de filas que puedan proceder de diferentes modelos de origen. Cada dato de la lista de índices ( QMimeData ) debe fusionarse, lo cual depende del tipo de datos. Reimplementa este método en una subclase si deseas permitir arrastrar varias filas.

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

Reimplementa: ` QAbstractItemModel::mimeTypes()` const.

Este método devuelve los tipos MIME del primer modelo de origen.

[override virtual] QModelIndex QConcatenateTablesProxyModel::parent(const QModelIndex &index) const

Reimplementa: ` QAbstractItemModel::parent(const QModelIndex &index) const`.

void QConcatenateTablesProxyModel::removeSourceModel(QAbstractItemModel *sourceModel)

Elimina el modelo de origen sourceModel, que se había añadido anteriormente a este proxy.

La propiedad de sourceModel no se ve afectada por esta acción.

[override virtual, since 6.9.0] QHash<int, QByteArray> QConcatenateTablesProxyModel::roleNames() const

Reimplementa: ` QAbstractItemModel::roleNames()` const.

Devuelve la unión de los nombres de roles (roleNames()) de los modelos subyacentes.

En caso de que los modelos fuente asocien nombres diferentes a un mismo rol, el nombre utilizado en el último modelo fuente anula el nombre utilizado en los modelos anteriores.

Esta función se introdujo en Qt 6.9.0.

[override virtual] int QConcatenateTablesProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const

Reimplementa: ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.

[override virtual] bool QConcatenateTablesProxyModel::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 QConcatenateTablesProxyModel::setItemData(const QModelIndex &proxyIndex, const QMap<int, QVariant> &roles)

Reimplementa: QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).

Véase también itemData().

QList<QAbstractItemModel *> QConcatenateTablesProxyModel::sourceModels() const

Devuelve una lista de los modelos que se han añadido como modelos de origen para este modelo proxy.

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

Reimplementa: ` QAbstractItemModel::span(const QModelIndex &index) 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.