Presentación de datos en una vista de tabla
Las clases ` QSqlQueryModel`, ` QSqlTableModel` y ` QSqlRelationalTableModel ` pueden utilizarse como fuente de datos para las clases de vista de Qt, tales como ` QListView`, ` QTableView` y ` QTreeView`. En la práctica, ` QTableView ` es, con diferencia, la opción más habitual, ya que un conjunto de resultados SQL es, en esencia, una estructura de datos bidimensional.

El siguiente ejemplo crea una vista basada en un modelo de datos SQL:
QTableView *view = new QTableView;
view->setModel(model);
view->show();Si el modelo es de lectura y escritura (por ejemplo, QSqlTableModel), la vista permite al usuario editar los campos. Puedes desactivar esta función llamando a
view->setEditTriggers(QAbstractItemView::NoEditTriggers);Se puede utilizar el mismo modelo como fuente de datos para varias vistas. Si el usuario edita el modelo a través de una de las vistas, las demás vistas reflejarán los cambios de inmediato. El ejemplo «Modelo de tabla» muestra cómo funciona.
Las clases de vista muestran un encabezado en la parte superior para etiquetar las columnas. Para cambiar los textos del encabezado, llama a setHeaderData() en el modelo. Las etiquetas del encabezado adoptan por defecto los nombres de los campos de la tabla. Por ejemplo:
model->setHeaderData(0, Qt::Horizontal, QObject::tr("ID"));
model->setHeaderData(1, Qt::Horizontal, QObject::tr("Name"));
model->setHeaderData(2, Qt::Horizontal, QObject::tr("City"));
model->setHeaderData(3, Qt::Horizontal, QObject::tr("Country"));QTableView también cuenta con un encabezado vertical a la izquierda con números que identifican las filas. Si se insertan filas mediante programación utilizando QSqlTableModel::insertRows(), las nuevas filas aparecerán marcadas con un asterisco (*) hasta que se envíen mediante submitAll() o automáticamente cuando el usuario pase a otro registro (suponiendo que edit strategy sea QSqlTableModel::OnRowChange).

Del mismo modo, si se eliminan filas mediante removeRows(), estas aparecerán marcadas con un signo de exclamación (!) hasta que se envíe el cambio.
Los elementos de la vista se representan mediante un delegado. El delegado predeterminado, QStyledItemDelegate, gestiona los tipos de datos más comunes (int, QString, QImage, etc.). El delegado también se encarga de proporcionar widgets de edición (por ejemplo, un cuadro combinado) cuando el usuario comienza a editar un elemento de la vista. Puedes crear tus propios delegados creando subclases de QAbstractItemDelegate o QStyledItemDelegate. Consulta Programación de modelo/vista para obtener más información.
QSqlTableModel está optimizado para operar sobre una sola tabla a la vez. Si necesitas un modelo de lectura y escritura que opere sobre un conjunto de resultados arbitrario, puedes crear una subclase de QSqlQueryModel y reimplementar flags() y setData() para convertirlo en un modelo de lectura y escritura. Las dos funciones siguientes permiten editar los campos 1 y 2 de un modelo de consulta:
Qt::ItemFlags EditableSqlModel::flags(const QModelIndex &index) const
{
Qt::ItemFlags flags = QSqlQueryModel::flags(index);
if (index.column() == 1 || index.column() == 2)
flags |= Qt::ItemIsEditable;
return flags;
}
bool EditableSqlModel::setData(const QModelIndex &index, const QVariant &value, int /* role */)
{
if (index.column() < 1 || index.column() > 2)
return false;
QModelIndex primaryKeyIndex = QSqlQueryModel::index(index.row(), 0);
int id = data(primaryKeyIndex).toInt();
clear();
bool ok;
if (index.column() == 1)
ok = setFirstName(id, value.toString());
else
ok = setLastName(id, value.toString());
refresh();
return ok;
}La función auxiliar setFirstName() se define de la siguiente manera:
bool EditableSqlModel::setFirstName(int personId, const QString &firstName)
{
QSqlQuery query;
query.prepare("update person set firstname = ? where id = ?");
query.addBindValue(firstName);
query.addBindValue(personId);
return query.exec();
}La función setLastName() es similar. Consulta el ejemplo «Query Model » para ver el código fuente completo.
Crear una subclase de un modelo permite personalizarlo de muchas formas: puedes añadir información sobre herramientas para los elementos, cambiar el color de fondo, proporcionar valores calculados, ofrecer valores distintos para la visualización y la edición, tratar los valores nulos de forma especial y mucho más. Consulta «Programación de modelos y vistas», así como la documentación de referencia de « QAbstractItemView » para obtener más detalles.
Si lo único que necesitas es convertir una clave foránea en una cadena más fácil de entender, puedes utilizar ` QSqlRelationalTableModel`. Para obtener los mejores resultados, también deberías utilizar ` QSqlRelationalDelegate`, un delegado que proporciona editores de cuadro combinado para editar claves foráneas.

El ejemplo «Modelo de tablas relacionales» ilustra cómo utilizar QSqlRelationalTableModel junto con QSqlRelationalDelegate para dotar a las tablas de compatibilidad con claves foráneas.
© 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.