QML and QSqlTableModel

From Qt Wiki
Jump to: navigation, search
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

I wrote a simple class derived from QSqlRelationalTableModel to facilitate the use of such classes with QML, without manually defining the roles.

If you want to understand why roles are so important when working with SQL table models and QML, have a look at this explained code snippet

class QLSqlTableModel : public QSqlRelationalTableModel {



   QHash<int, QByteArray> roles;


   QLSqlTableModel(QObject *parent = 0);


   Q_INVOKABLE QVariant data(const QModelIndex &index, int role=Qt::DisplayRole ) const;
   void generateRoleNames();
  1. ifdef HAVE_QT5
   virtual QHash<int, QByteArray> roleNames() const{return roles;}
  1. endif


QVariant QLSqlTableModel::data ( const QModelIndex & index, int role ) const {

   if(index.row() >= rowCount())
       return QString("");
   if(role < Qt::UserRole)
       return QSqlQueryModel::data(index, role);
       // search for relationships
       for (int i = 0; i < columnCount(); i+) 
           if (this->relation(i).isValid()) 
           return record(index.row()).value(QString(roles.value(role)));
   // if no valid relationship was found
   return QSqlQueryModel::data(this->index(index.row(), role - Qt::UserRole - 1), Qt::DisplayRole);


The data method returns the value of the role used. If there is a relationship in the table, i search the column with relation and return the correct value.. Note that empty string is returned when the item is not found and not QVariant value, in order to have a correct visualization in QML.

void QLSqlTableModel::generateRoleNames() {

   int nbCols = this->columnCount();
   for (int i = 0; i < nbCols; i) 
       roles[Qt::UserRole + i + 1] = QVariant(this->headerData(i, Qt::Horizontal).toString()).toByteArray();
  1. ifndef HAVE_QT5
  1. endif


The generateRoleNames method creates the roles called as the table columns specified in the header.



query.exec("create table IF NOT EXISTS items (id integer primary key autoincrement,

           name varchar(15), descr varchar(30))");

query.exec("create table IF NOT EXISTS lista (id integer primary key autoincrement,

           qta varchar(30), item INTEGER, FOREIGN KEY (item) REFERENCES items(id))");


QLSqlTableModel *model = new QLSqlTableModel; QLSqlTableModel *modelLista = new QLSqlTableModel;

model->setTable("items"); model->generateRoleNames(); model->select();

modelLista->setTable("lists"); modelLista->setRelation(2, QSqlRelation("items", "id", "name")); modelLista->select(); modelLista->generateRoleNames();

QDeclarativeContext *ctxt = view.rootContext(); ctxt->setContextProperty("modelListItems", model); ctxt->setContextProperty("modelList", modelLista);

In qml file Text {

   id: name
   text: model.name
   font.bold: true; font.pointSize: 16
   color: "white"


Text {

   text: "Amount: " + model.qta
   font.pointSize: 16
   opacity: 1
   color: "white"


Note1: Nice post, however the performance can be tweaked. data() will be called very often. Most of the processing and object instantiation should be done only once.

Note2: I modified provided code according to this working example which was based on this wiki page