Questions about models

[xtal256]

I have a few questions about the models.

Say i have the following classes:

class SubItem {
    // some properties...
};
 
class Item {
    // some properties...
    QList<SubItem> subitems;
};

class SubItem {
    // some properties...
};

class Item {
    // some properties...
    QList<SubItem> subitems;
};

To copy to clipboard, switch view to plain text mode 

Now, i have a UI which displays those items. It is an MDI, where each window has a form layout which displays the properties of the Item.

Most of the properties can just be displayed on a QLabel, but for the list of subitems i need a list-based widget (QListWidget/QListView or QTableWidget/View).

Currently, i am just using the Q*Widget classes. But i would like to use proper model/view programming and use a Q*View.
The problem is that i am not sure how to use a list model in this case. I started to think about the class definitions and realised i have no idea how it will work:

class SubItem...
 
class Item {
   SubItemListModel getSubItemListModel();
}
 
class SubItemListModel {
   Item* item;     // A reference to the object which contains the list.
 
   QList<SubItem> getItems() { item->getSubItems(); }
}

class SubItem...

class Item {
   SubItemListModel getSubItemListModel();
}

class SubItemListModel {
   Item* item;     // A reference to the object which contains the list.

   QList<SubItem> getItems() { item->getSubItems(); }
}

To copy to clipboard, switch view to plain text mode 

Should the SubItemListModel work with the data in the Item's list, or should the Item have it's list data in a SubItemListModel?


Also another minor question - i have my UI classes defined in .cpp files in one folder, and my "model" (or data) classes (Item, SubItem, etc) defined in another folder. This is separation of data and ui. But if i were to start using Qt's model classes (derived from QAbstractItemModel), where would they be defined? With my data classes, or the UI classes? Because as i see it, Q*Models are more about providing data to the UI, rather than actually storing data themselves.

[xtal256]

Any response?

One of the things i don't understand about Qt's model classes is that they are models of lists of items. What do i do when i want to model a single item? Obviously, such a model wouldn't be used with any list views (tree, table), but it seems that Qt's model/view is build only around this concept of lists.

[Santosh Reddy]

Should the SubItemListModel work with the data in the Item's list, or should the Item have it's list data in a SubItemListModel?

The better way is to have a Model (Say MyModel)

class MyModel : public QAbstractItemModel
{
public:
    class SubItem {
    // some properties...
};
 
class Item {
    // some properties...
    QList<SubItem> subitems;
};
 
    SubItem mainItem;
};

class MyModel : public QAbstractItemModel
{
public:
    class SubItem {
    // some properties...
};

class Item {
    // some properties...
    QList<SubItem> subitems;
};

    SubItem mainItem;
};

To copy to clipboard, switch view to plain text mode 

now MyModel has all the knowledge of Item and SubItem class, it can act as model to any type view, just implement the virtual calls properly.

Also another minor question - i have my UI classes defined in .cpp files in one folder, and my "model" (or data) classes (Item, SubItem, etc) defined in another folder. This is separation of data and ui. But if i were to start using Qt's model classes (derived from QAbstractItemModel), where would they be defined? With my data classes, or the UI classes? Because as i see it, Q*Models are more about providing data to the UI, rather than actually storing data themselves.

I will say the model classes will go with the data.

One of the things i don't understand about Qt's model classes is that they are models of lists of items. What do i do when i want to model a single item? Obviously, such a model wouldn't be used with any list views (tree, table), but it seems that Qt's model/view is build only around this concept of lists.

If you closely observe the interface calls, they are not restricting you to have list as a model, you can have any variety of data structure as your data container, or even get the data from internet or dynamically create data based on state and return to the view.

[xtal256]

Ok, take the following example:

An application needs to store and display information about people and their job history. Each person has details such as name, address, D.O.B, etc, as well as a list of previous employment. Items in this list contains details such the job name/title, date started, date finished, etc.

Here we have a case where information is nested. There will be a list of people, and each person item will have a list of jobs.

Now, this application will display information about a person in a property page (e.g. MDI window). This window will have name, address, etc as QLabels in a QFormLayout, and the employment history will be in a table view below the QFormLayout.

C++ being an object-oriented language, a Person and Job class is created:

class Job {
    QString name;
    QDate startDate;
    //...
};
 
class Person {
    QString name;
    QString address;
    QList<Job> employmentHistory;
    //...
};

class Job {
    QString name;
    QDate startDate;
    //...
};

class Person {
    QString name;
    QString address;
    QList<Job> employmentHistory;
    //...
};

To copy to clipboard, switch view to plain text mode 

The application maintains a list of Person objects. The person and job data is not stored in a database, let's just say that it is obtained some other way.


So, how would i do this using Qt's model/view classes? Do i need to scrap the Job and Person classes in favour of QAbstractItemModel subclasses, which return the properties (name, address, etc) as columns? And how do i handle the nesting?

[Santosh Reddy]

So good you already have container for data list of persons, and list of jobs for each person, you just need to give this data to the view using QAbstractItemModel. Here I will give a heads up

class Job {
    QString name;
    QDate startDate;
};
 
class Person {
    QString name;
    QString address;
    QList<Job> employmentHistory;
};
 
class MyModel : public QAbstractItemModel
{
public:
    int rowCount(QModelIndex index)
    {
        if(!index.isValid())
            return p.count();
        return 0;
    }
 
    int columnCount(QModelIndex index)
    {
        return 2; // say 2 columns, name & address (or name & start date)
    }
 
    QVariant data(QModelIndex index, int role)
    {
        if(role == Qt::DataRole)
        {
            if(index.column() == 0)
                return p.at(index.row()).name;
            if(index.column() == 1)
                return p.at(index.row()).address;
        }
        return QVariant();
    }
 
    // implement other required interface calls also.
private:
    QList<Person> p; // have your list of persons in here, or a pointer to point to the actual data
};

class Job {
    QString name;
    QDate startDate;
};

class Person {
    QString name;
    QString address;
    QList<Job> employmentHistory;
};

class MyModel : public QAbstractItemModel
{
public:
    int rowCount(QModelIndex index)
    {
        if(!index.isValid())
            return p.count();
        return 0;
    }

    int columnCount(QModelIndex index)
    {
        return 2; // say 2 columns, name & address (or name & start date)
    }

    QVariant data(QModelIndex index, int role)
    {
        if(role == Qt::DataRole)
        {
            if(index.column() == 0)
                return p.at(index.row()).name;
            if(index.column() == 1)
                return p.at(index.row()).address;
        }
        return QVariant();
    }

    // implement other required interface calls also.
private:
    QList<Person> p; // have your list of persons in here, or a pointer to point to the actual data
};

To copy to clipboard, switch view to plain text mode 

[xtal256]

Right, that much i got. Basically, the model returns the data's members as columns.
But that still doesn't help me, you have not mentioned how to model the Job list within each Person object.

[xtal256]

Anyone?

Surely others must have this problem, or at least understand the problem i have.

[boudie]

You could create a second Model, like Santosh showed you, serving Job info (the Jobs Model).
Now there are two ways you can go:
1. Make some kind of selection possible in the Jobs Model to select only jobs for a selected person, or
2. Give every person an instance of the Jobs model class.

If you do 1), you only have to connect one Jobs Model to the View. It will be updated with the correct values when scrolling through Persons, because Persons updates the Jobs selection.
If you go for 2), you have to connect (setModel) the right Jobs Model to the View when a new Person is selected.

I don't know what's best. And maybe there are better ways...

[xtal256]

You could create a second Model, like Santosh showed you, serving Job info (the Jobs Model).

Santosh never mentioned a second Model. He only ever showed me how to create a single model (which i already know how to do).

As for your ideas, it seems like Qt's models just aren't built for this kind of thing. For now i guess i will stick to using QTableWidgets for this.

[boudie]

What I meant was: you create a second model in the same way you created the first one.
I think Qt can handle this very well; I described two options to implement it. It's up to you to decide which option you think is best.
Once you've tried, feel free to ask for detailed help.

[marcvanriet]

As for your ideas, it seems like Qt's models just aren't built for this kind of thing. For now i guess i will stick to using QTableWidgets for this.

Models are build for this kind of things, but a model can be only for 1 kind of data : it cannot be a model both for persons, and also for jobs.

Compare it with a simple relational database : you have a table with persons, and a table with jobs, and they are linked together using some sort of index field. In this case, each record in the 'jobs' table will have a field to say whose job this is or was. If you make a GUI around this, you would make an instance of a 'PersonsModel' class, and an instance of a 'JobsModel' class. Then when a different person is selected in the PersonsModel, you could set a filter in the JobsModel to show only the job history of this person.

One of the things i don't understand about Qt's model classes is that they are models of lists of items. What do i do when i want to model a single item?

It is also my understanding that models are only for lists of items (persons, jobs, ...). In your example you want to keep the information about more than 1 person, don't you ? If you want to keep information about just 1 item (although I can't really think of a practical example of such a case), then you can can create a model which has just 1 entry in it - like a database table with just 1 record in it.

I'm really not very familiar with model/view programming, so I don't think I can be of any futher help. Maybe you can check out the Master-Detail example.

Regards,
Marc