Widgets Tutorial - Nested Layouts

Just as widgets can contain other widgets, layouts can be used to provide different levels of grouping for widgets. Here, we want to display a label alongside a line edit at the top of a window, above a table view showing the results of a query.

We achieve this by creating two layouts: queryLayout is a QHBoxLayout that contains QLabel and QLineEdit widgets placed side-by-side; mainLayout is a QVBoxLayout that contains queryLayout and a QTableView arranged vertically.

 #include <QtWidgets>

 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);
     QWidget window;

     QLabel *queryLabel = new QLabel(
         QApplication::translate("nestedlayouts", "Query:"));
     QLineEdit *queryEdit = new QLineEdit();
     QTableView *resultView = new QTableView();

     QHBoxLayout *queryLayout = new QHBoxLayout();
     queryLayout->addWidget(queryLabel);
     queryLayout->addWidget(queryEdit);

     QVBoxLayout *mainLayout = new QVBoxLayout();
     mainLayout->addLayout(queryLayout);
     mainLayout->addWidget(resultView);
     window.setLayout(mainLayout);

     // Set up the model and configure the view...
     window.setWindowTitle(
         QApplication::translate("nestedlayouts", "Nested layouts"));
     window.show();
     return app.exec();
 }

Note that we call the mainLayout's addLayout() function to insert the queryLayout above the resultView table.

We have omitted the code that sets up the model containing the data shown by the QTableView widget, resultView. For completeness, we show this below.

As well as QHBoxLayout and QVBoxLayout, Qt also provides QGridLayout and QFormLayout classes to help with more complex user interfaces. These can be seen if you run Qt Designer.

Setting up the Model

In the code above, we did not show where the table's data came from because we wanted to concentrate on the use of layouts. Here, we see that the model holds a number of items corresponding to rows, each of which is set up to contain data for two columns.

     QStandardItemModel model;
     model.setHorizontalHeaderLabels(
         QStringList() << QApplication::translate("nestedlayouts", "Name")
                       << QApplication::translate("nestedlayouts", "Office"));

     QList<QStringList> rows = QList<QStringList>()
         << (QStringList() << "Verne Nilsen" << "123")
         << (QStringList() << "Carlos Tang" << "77")
         << (QStringList() << "Bronwyn Hawcroft" << "119")
         << (QStringList() << "Alessandro Hanssen" << "32")
         << (QStringList() << "Andrew John Bakken" << "54")
         << (QStringList() << "Vanessa Weatherley" << "85")
         << (QStringList() << "Rebecca Dickens" << "17")
         << (QStringList() << "David Bradley" << "42")
         << (QStringList() << "Knut Walters" << "25")
         << (QStringList() << "Andrea Jones" << "34");

     foreach (QStringList row, rows) {
         QList<QStandardItem *> items;
         foreach (QString text, row)
             items.append(new QStandardItem(text));
         model.appendRow(items);
     }

     resultView->setModel(&model);
     resultView->verticalHeader()->hide();
     resultView->horizontalHeader()->setStretchLastSection(true);

The use of models and views is covered in the Item Views Examples and in the Model/View Programming overview.

Files:

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.

Documentation sources may be obtained from www.qt-project.org.

Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia.	Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !

Responsables bénévoles de la rubrique Qt : Thibaut Cuvelier - Jonathan Courtois -

Developpez.com

Services

Partenaires