Using Models and Views

Introduction
Using Views with an Existing Model

Introduction

Two of the standard models provided by Qt are QStandardItemModel and QDirModel. QStandardItemModel is a multi-purpose model that can be used to represent various different data structures needed by list, table, and tree views. This model also holds the items of data. QDirModel is a model that maintains information about the contents of a directory. As a result, it does not hold any items of data itself, but simply represents files and directories on the local filing system.

QDirModel provides a ready-to-use model to experiment with, and can be easily configured to use existing data. Using this model, we can show how to set up a model for use with ready-made views, and explore how to manipulate data using model indexes.

Using Views with an Existing Model

The QListView and QTreeView classes are the most suitable views to use with QDirModel. The example presented below displays the contents of a directory in a tree view next to the same information in a list view. The views share the user's selection so that the selected items are highlighted in both views.

We set up a QDirModel so that it is ready for use, and create some views to display the contents of a directory. This shows the simplest way to use a model. The construction and use of the model is performed from within a single main() function:

    int main(int argc, char *argv[])
    {
        QApplication app(argc, argv);
        QSplitter *splitter = new QSplitter;

        QDirModel *model = new QDirModel;

The model is set up to use data from a default directory. We create two views so that we can examine the items held in the model in two different ways:

        QTreeView *tree = new QTreeView(splitter);
        tree->setModel(model);
        tree->setRootIndex(model->index(QDir::currentPath()));

        QListView *list = new QListView(splitter);
        list->setModel(model);
        list->setRootIndex(model->index(QDir::currentPath()));

The views are constructed in the same way as other widgets. Setting up a view to display the items in the model is simply a matter of calling its setModel() function with the directory model as the argument. The calls to setRootIndex() tell the views which directory to display by supplying a model index that we obtain from the directory model.

The index() function used in this case is unique to QDirModel; we supply it with a directory and it returns a model index. Model indexes are discussed in the Model Classes chapter.

The rest of the function just displays the views within a splitter widget, and runs the application's event loop:

        splitter->setWindowTitle("Two views onto the same directory model");
        splitter->show();
        return app.exec();
    }

In the above example, we neglected to mention how to handle selections of items. This subject is covered in more detail in the chapter on Handling Selections in Item Views. Before examining how selections are handled, you may find it useful to read the Model Classes chapter which describes the concepts used in the model/view framework.

[Previous: Model/View Programming] [Contents] [Next: Model Classes]

Trademarks

Qt 4.1.3