En esta página

Tutorial de widgets: diseños anidados

Del mismo modo que los widgets pueden contener otros widgets, los diseños se pueden utilizar para proporcionar diferentes niveles de agrupación de widgets. En este caso, queremos mostrar una etiqueta junto a un campo de edición de línea en la parte superior de una ventana, encima de una vista de tabla que muestra los resultados de una consulta.

Para ello, creamos dos diseños: queryLayout es un QHBoxLayout que contiene los widgets QLabel y QLineEdit colocados uno al lado del otro; mainLayout es un QVBoxLayout que contiene queryLayout y un QTableView dispuestos verticalmente.

#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();
}
Widgets para consultar y mostrar un modelo mediante un diseño anidado

Ten en cuenta que llamamos a la función addLayout() del mainLayout para insertar el queryLayout encima de la tabla resultView.

Hemos omitido el código que configura el modelo que contiene los datos mostrados por el widget « QTableView », resultView. Para completar la información, lo mostramos a continuación.

Además de QHBoxLayout y QVBoxLayout, Qt también proporciona las clases QGridLayout y QFormLayout para facilitar el desarrollo de interfaces de usuario más complejas. Estas se pueden ver si se ejecuta Qt Widgets Designer.

Configuración del modelo

En el código anterior, no mostramos de dónde procedían los datos de la tabla porque queríamos centrarnos en el uso de los diseños. Aquí vemos que el modelo contiene varios elementos que corresponden a las filas, cada uno de los cuales está configurado para contener datos de dos columnas.

    QStandardItemModel model;
    model.setHorizontalHeaderLabels({ QApplication::translate("nestedlayouts", "Name"),
                                      QApplication::translate("nestedlayouts", "Office") });

    const QStringList rows[] = {
        QStringList{ QStringLiteral("Verne Nilsen"), QStringLiteral("123") },
        QStringList{ QStringLiteral("Carlos Tang"), QStringLiteral("77") },
        QStringList{ QStringLiteral("Bronwyn Hawcroft"), QStringLiteral("119") },
        QStringList{ QStringLiteral("Alessandro Hanssen"), QStringLiteral("32") },
        QStringList{ QStringLiteral("Andrew John Bakken"), QStringLiteral("54") },
        QStringList{ QStringLiteral("Vanessa Weatherley"), QStringLiteral("85") },
        QStringList{ QStringLiteral("Rebecca Dickens"), QStringLiteral("17") },
        QStringList{ QStringLiteral("David Bradley"), QStringLiteral("42") },
        QStringList{ QStringLiteral("Knut Walters"), QStringLiteral("25") },
        QStringList{ QStringLiteral("Andrea Jones"), QStringLiteral("34") }
    };

    QList<QStandardItem *> items;
    for (const QStringList &row : rows) {
        items.clear();
        for (const QString &text : row)
            items.append(new QStandardItem(text));
        model.appendRow(items);
    }

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

El uso de modelos y vistas se trata en los Ejemplos de vistas de elementos y en la descripción general de la programación Modelo/Vista.

Proyecto de ejemplo en @code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. 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. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.