Tutorial sobre widgets: uso de diseños

Normalmente, los widgets secundarios se disponen dentro de una ventana utilizando objetos de diseño, en lugar de especificar posiciones y tamaños de forma explícita. En este ejemplo, creamos un widget de etiqueta y otro de campo de texto que queremos disponer uno al lado del otro.

#include <QtWidgets>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QWidget window;
    QLabel *label = new QLabel(QApplication::translate("windowlayout", "Name:"));
    QLineEdit *lineEdit = new QLineEdit();

    QHBoxLayout *layout = new QHBoxLayout();
    layout->addWidget(label);
    layout->addWidget(lineEdit);
    window.setLayout(layout);
    window.setWindowTitle(
        QApplication::translate("windowlayout", "Window layout"));
    window.show();
    return app.exec();
}
Etiqueta junto a un campo de texto en un diseño horizontal

El objeto ` layout ` que creamos gestiona las posiciones y los tamaños de los widgets que se le pasan mediante la función ` addWidget()`. El propio diseño se pasa a la ventana en la llamada a ` setLayout()`. Los diseños solo son visibles a través de los efectos que tienen sobre los widgets (y otros diseños) de cuya gestión son responsables.

En el ejemplo anterior, la propiedad de cada widget no queda clara de inmediato. Dado que creamos los widgets y el diseño sin objetos padres, cabría esperar ver una ventana vacía y dos ventanas separadas que contienen una etiqueta y un campo de edición de línea. Sin embargo, cuando le indicamos al diseño que gestione la etiqueta y el campo de edición de línea y establecemos el diseño en la ventana, tanto los widgets como el propio diseño se «reasignan» para convertirse en hijos de la ventana.

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.