En esta página

Ejemplo de diseños básicos

Muestra cómo utilizar los gestores de diseño estándar.

«Diseños básicos» muestra cómo utilizar los gestores de diseño estándar disponibles en Qt: QBoxLayout, QGridLayout y QFormLayout.

Captura de pantalla del ejemplo «Diseños básicos»

La clase ` QBoxLayout ` alinea los widgets horizontal o verticalmente. ` QHBoxLayout ` y ` QVBoxLayout ` son subclases de conveniencia de ` QBoxLayout`. ` QGridLayout ` distribuye los widgets en celdas dividiendo el espacio disponible en filas y columnas. ` QFormLayout`, por su parte, coloca sus elementos hijos en un formato de dos columnas, con las etiquetas en la columna izquierda y los campos de entrada en la columna derecha.

Para obtener más información, visita la página de gestión de diseños.

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Definición de la clase de diálogo

class Dialog : public QDialog
{
    Q_OBJECT

public:
    Dialog();

private:
    void createMenu();
    void createHorizontalGroupBox();
    void createGridGroupBox();
    void createFormGroupBox();

    enum { NumGridRows = 3, NumButtons = 4 };

    QMenuBar *menuBar;
    QGroupBox *horizontalGroupBox;
    QGroupBox *gridGroupBox;
    QGroupBox *formGroupBox;
    QTextEdit *smallEditor;
    QTextEdit *bigEditor;
    QLabel *labels[NumGridRows];
    QLineEdit *lineEdits[NumGridRows];
    QPushButton *buttons[NumButtons];
    QDialogButtonBox *buttonBox;

    QMenu *fileMenu;
    QAction *exitAction;
};

La clase ` Dialog ` hereda de ` QDialog`. Se trata de un widget personalizado que muestra sus widgets hijos utilizando los gestores de geometría: ` QHBoxLayout`, ` QVBoxLayout`, ` QGridLayout` y ` QFormLayout`.

Hay cuatro funciones privadas que simplifican el constructor de la clase: las funciones createMenu(), createHorizontalGroupBox(), createGridGroupBox() y createFormGroupBox() crean varios widgets que el ejemplo utiliza para demostrar cómo el diseño afecta a su aspecto.

Implementación de la clase `Dialog`

Dialog::Dialog()
{
    createMenu();
    createHorizontalGroupBox();
    createGridGroupBox();
    createFormGroupBox();

En el constructor, primero utilizamos la función ` createMenu() ` para crear y rellenar una barra de menús, y la función ` createHorizontalGroupBox() ` para crear un cuadro de grupo que contiene cuatro botones con un diseño horizontal. A continuación, utilizamos la función ` createGridGroupBox() ` para crear un cuadro de grupo que contiene varios campos de edición de línea y un pequeño editor de texto, los cuales se muestran en un diseño de cuadrícula. Por último, utilizamos la función ` createFormGroupBox() ` para crear un cuadro de grupo con tres etiquetas y tres campos de entrada: un campo de edición de línea, un cuadro combinado y un cuadro giratorio.

    bigEditor = new QTextEdit;
    bigEditor->setPlainText(tr("This widget takes up all the remaining space "
                               "in the top-level layout."));

    buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok
                                     | QDialogButtonBox::Cancel);

    connect(buttonBox, &QDialogButtonBox::accepted, this, &QDialog::accept);
    connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::reject);

También creamos un editor de texto grande y un cuadro de diálogo con botones. La clase ` QDialogButtonBox ` es un widget que presenta botones en una disposición adecuada al estilo del widget actual. Los botones preferidos se pueden especificar como argumentos del constructor, utilizando la enumeración ` QDialogButtonBox::StandardButtons `.

Ten en cuenta que no es necesario especificar un padre para los widgets al crearlos. El motivo es que todos los widgets que creamos aquí se añadirán a un diseño, y cuando añadimos un widget a un diseño, se le asigna automáticamente como padre el widget en el que está instalado el diseño.

    QVBoxLayout *mainLayout = new QVBoxLayout;

El diseño principal es un objeto ` QVBoxLayout `. ` QVBoxLayout ` es una clase de conveniencia para un diseño de caja con orientación vertical.

En general, la clase ` QBoxLayout ` toma el espacio que recibe (de su diseño padre o del widget padre), lo divide en una serie de recuadros y hace que cada widget gestionado ocupe un recuadro. Si la orientación de ` QBoxLayout` es ` Qt::Horizontal `, los recuadros se colocan en una fila. Si la orientación es ` Qt::Vertical`, los recuadros se colocan en una columna. Las clases de conveniencia correspondientes son QHBoxLayout y QVBoxLayout, respectivamente.

    mainLayout->setMenuBar(menuBar);

Cuando llamamos a la función ` QLayout::setMenuBar()` , el diseño coloca la barra de menú proporcionada en la parte superior del widget padre, y fuera del área de contenido ` content margins` del widget. Todos los widgets hijos se colocan por debajo del borde inferior de la barra de menú.

    mainLayout->addWidget(horizontalGroupBox);
    mainLayout->addWidget(gridGroupBox);
    mainLayout->addWidget(formGroupBox);
    mainLayout->addWidget(bigEditor);
    mainLayout->addWidget(buttonBox);

Utilizamos la función ` QBoxLayout::addWidget()` para añadir los widgets al final del diseño. Cada widget ocupará, como mínimo, su tamaño mínimo y, como máximo, su tamaño máximo. Es posible especificar un factor de expansión en la función ` addWidget()`, y cualquier espacio sobrante se distribuye según estos factores de expansión. Si no se especifica, el factor de expansión de un widget es 0.

    setLayout(scrollLayout);
    setWindowTitle(tr("Basic Layouts"));
}

Instalamos el diseño principal en el widget ` Dialog ` mediante la función ` QWidget::setLayout()`, y todos los widgets del diseño pasan automáticamente a ser hijos del widget ` Dialog `.

void Dialog::createMenu()
{
    menuBar = new QMenuBar;

    fileMenu = new QMenu(tr("&File"), this);
    exitAction = fileMenu->addAction(tr("E&xit"));
    menuBar->addMenu(fileMenu);

    connect(exitAction, &QAction::triggered, this, &QDialog::accept);
}

En la función privada ` createMenu() `, creamos una barra de menús y añadimos un menú desplegable ` File ` que contiene la opción ` Exit `.

void Dialog::createHorizontalGroupBox()
{
    horizontalGroupBox = new QGroupBox(tr("Horizontal layout"));
    QHBoxLayout *layout = new QHBoxLayout;

    for (int i = 0; i < NumButtons; ++i) {
        buttons[i] = new QPushButton(tr("Button %1").arg(i + 1));
        layout->addWidget(buttons[i]);
    }
    horizontalGroupBox->setLayout(layout);
}

Al crear el cuadro de grupo horizontal, utilizamos un « QHBoxLayout » como diseño interno. Creamos los botones que queremos incluir en el cuadro de grupo, los añadimos al diseño e instalamos este último en el cuadro de grupo.

void Dialog::createGridGroupBox()
{
    gridGroupBox = new QGroupBox(tr("Grid layout"));

En la función createGridGroupBox() utilizamos un QGridLayout que distribuye los widgets en una cuadrícula. Este toma el espacio que tiene disponible (ya sea del diseño padre o del widget padre), lo divide en filas y columnas, y coloca cada widget que gestiona en la celda correcta.

    for (int i = 0; i < NumGridRows; ++i) {
        labels[i] = new QLabel(tr("Line %1:").arg(i + 1));
        lineEdits[i] = new QLineEdit;
        layout->addWidget(labels[i], i + 1, 0);
        layout->addWidget(lineEdits[i], i + 1, 1);
    }

Para cada fila de la cuadrícula creamos una etiqueta y un campo de edición de línea asociado, y los añadimos al diseño. La función QGridLayout::addWidget() difiere de la función correspondiente de QBoxLayout: necesita la fila y la columna que especifican la celda de la cuadrícula en la que se colocará el widget.

    smallEditor = new QTextEdit;
    smallEditor->setPlainText(tr("This widget takes up about two thirds of the "
                                 "grid layout."));
    layout->addWidget(smallEditor, 0, 2, 4, 1);

QGridLayout::addWidgetAdemás, () puede aceptar argumentos que especifiquen el número de filas y columnas que abarcará la celda. En este ejemplo, creamos un pequeño editor que abarca tres filas y una columna.

Tanto para la función QBoxLayout::addWidget() como para QGridLayout::addWidget(), también es posible añadir un último argumento que especifique la alineación del widget. Por defecto, ocupa toda la celda. Pero podríamos, por ejemplo, alinear un widget con el borde derecho especificando la alineación como Qt::AlignRight.

    layout->setColumnStretch(1, 10);
    layout->setColumnStretch(2, 20);
    gridGroupBox->setLayout(layout);
}

Cada columna de un diseño de cuadrícula tiene un factor de estiramiento. El factor de estiramiento se establece mediante QGridLayout::setColumnStretch() y determina qué parte del espacio disponible ocupará la columna por encima de su mínimo necesario.

En este ejemplo, establecemos los factores de expansión para las columnas 1 y 2. El factor de expansión es relativo con respecto a las demás columnas de esta cuadrícula; las columnas con un factor de expansión mayor ocupan más espacio disponible. Por lo tanto, la columna 2 de nuestro diseño de cuadrícula ocupará más espacio disponible que la columna 1, y la columna 0 no se ampliará en absoluto, ya que su factor de expansión es 0 (el valor por defecto).

Las columnas y las filas se comportan de forma idéntica; existe un factor de expansión equivalente para las filas, así como una función ` QGridLayout::setRowStretch()`.

void Dialog::createFormGroupBox()
{
    formGroupBox = new QGroupBox(tr("Form layout"));
    QFormLayout *layout = new QFormLayout;
    layout->addRow(new QLabel(tr("Line 1:")), new QLineEdit);
    layout->addRow(new QLabel(tr("Line 2, long text:")), new QComboBox);
    layout->addRow(new QLabel(tr("Line 3:")), new QSpinBox);
    formGroupBox->setLayout(layout);
}

En la función ` createFormGroupBox() `, utilizamos un ` QFormLayout ` para organizar de forma ordenada los objetos en dos columnas: «nombre» y «campo». Hay tres objetos ` QLabel ` para los nombres con tres widgets de entrada correspondientes como campos: un ` QLineEdit`, un ` QComboBox ` y un ` QSpinBox`. A diferencia de ` QBoxLayout::addWidget()` y ` QGridLayout::addWidget()`, utilizamos ` QFormLayout::addRow()` para añadir widgets al diseño.

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.