A Collection of classes to easily create models with QObject and Q_GADGET classes for widgets and quick

version 2.1.0

To install:

❯ qpm install de.skycoder42.qobjectlistmodel


A Collection of classes to easily create models with QObject and G_GADGET classes for widgets and quick


  • A QAbstractListModel for QObjects
    • Maps properties to display roles
    • Supports dynamic properties (if declared)
    • Forwards property changes as model changes
    • Can be used in QML ListView
  • Generic version for easier use in code
  • A QAbstractListModel for Q_GADGET classes
    • Simplefied version for gadgets
    • Works just like the QObject-Version, but gadgets have neither signals nor dynamic properties and are value types
  • Proxy Model to map roles to columns
    • Works with any QAbstractListModel (item models with 1 column and no children)
    • Allows you to use the model for QAbstractItemView (e.g. QTreeView or QTableView)
    • Maps any role to a column + role (e.g. name role to {column 0, display role})
    • Custom header names
    • Correctly forwards propert changes
    • Editing does not work

One of the main advantages of this library is that you can use one model for both, a role-based QML ListView, and a column-based widgets QAbstractItemView, and that all property changes trigger data changes in the model and the views.


The package is providet as qpm package, de.skycoder42.qobjectlistmodel. To install:

  1. Install qpm (See GitHub - Installing, for windows see below)
  2. In your projects root directory, run qpm install de.skycoder42.qobjectlistmodel
  3. Include qpm to your project by adding include(vendor/vendor.pri) to your .pro file

Check their GitHub - Usage for App Developers to learn more about qpm.

Important for Windows users: QPM Version 0.10.0 (the one you can download on the website) is currently broken on windows! It's already fixed in master, but not released yet. Until a newer versions gets released, you can download the latest dev build from here:


Thanks to the generic version, usage is pretty straight forward. The model has simple add/insert/remove methods to easily add objects, and can take ownership of it's objects. The following code shows how to create a qobject list model as well as the proxy.

// create and use the model
auto model = new QGenericListModel<MyObject>(true, this);//true to be owner of objects

// add items
model->addObject(new MyObject(...));

// use the proxy
auto proxy = new QObjectProxyModel({"Name", "Info"}, this);// The headers. In this case 2 colums with the given headers are created
proxy->setSourceModel(model);// IMPORTANT! Must be done before setting up the mappings
proxy->addMapping(0, Qt::DisplayRole, "name");// Maps the display role of column 0 to the "name" role of the source model
proxy->addMapping(1, Qt::DisplayRole, "text");// Maps the display role of column 1 to the "text" role of the source model

To use the model in qml, all you need to do is create a custom delegate and assign the roles:

ListView {
	model: listModel //model from c++, e.g. as a context property

	delegate: ItemDelegate {
		width: parent.width
		text: name
		ToolTip.text: model.text //use model.* if the role name is reserved

Check the ModelTest Project for a full example.



View on Github

License: BSD_3_CLAUSE

Today 2
This week 8
This month 13
This year 141
Total 687