En esta página

QFormLayout Class

La clase QFormLayout gestiona los formularios de los controles de entrada y sus etiquetas asociadas. Más información...

Encabezado: #include <QFormLayout>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QLayout

Tipos públicos

struct TakeRowResult
enum FieldGrowthPolicy { FieldsStayAtSizeHint, ExpandingFieldsGrow, AllNonFixedFieldsGrow }
enum ItemRole { LabelRole, FieldRole, SpanningRole }
enum RowWrapPolicy { DontWrapRows, WrapLongRows, WrapAllRows }

Propiedades

Funciones públicas

QFormLayout(QWidget *parent = nullptr)
virtual ~QFormLayout()
void addRow(QWidget *label, QWidget *field)
void addRow(QLayout *layout)
void addRow(QWidget *widget)
void addRow(QWidget *label, QLayout *field)
void addRow(const QString &labelText, QLayout *field)
void addRow(const QString &labelText, QWidget *field)
QFormLayout::FieldGrowthPolicy fieldGrowthPolicy() const
Qt::Alignment formAlignment() const
void getItemPosition(int index, int *rowPtr, QFormLayout::ItemRole *rolePtr) const
void getLayoutPosition(QLayout *layout, int *rowPtr, QFormLayout::ItemRole *rolePtr) const
void getWidgetPosition(QWidget *widget, int *rowPtr, QFormLayout::ItemRole *rolePtr) const
int horizontalSpacing() const
void insertRow(int row, QWidget *label, QWidget *field)
void insertRow(int row, QLayout *layout)
void insertRow(int row, QWidget *widget)
void insertRow(int row, QWidget *label, QLayout *field)
void insertRow(int row, const QString &labelText, QLayout *field)
void insertRow(int row, const QString &labelText, QWidget *field)
(since 6.4) bool isRowVisible(int row) const
(since 6.4) bool isRowVisible(QLayout *layout) const
(since 6.4) bool isRowVisible(QWidget *widget) const
QLayoutItem *itemAt(int row, QFormLayout::ItemRole role) const
Qt::Alignment labelAlignment() const
QWidget *labelForField(QWidget *field) const
QWidget *labelForField(QLayout *field) const
void removeRow(int row)
void removeRow(QLayout *layout)
void removeRow(QWidget *widget)
int rowCount() const
QFormLayout::RowWrapPolicy rowWrapPolicy() const
void setFieldGrowthPolicy(QFormLayout::FieldGrowthPolicy policy)
void setFormAlignment(Qt::Alignment alignment)
void setHorizontalSpacing(int spacing)
void setItem(int row, QFormLayout::ItemRole role, QLayoutItem *item)
void setLabelAlignment(Qt::Alignment alignment)
void setLayout(int row, QFormLayout::ItemRole role, QLayout *layout)
(since 6.4) void setRowVisible(int row, bool on)
(since 6.4) void setRowVisible(QLayout *layout, bool on)
(since 6.4) void setRowVisible(QWidget *widget, bool on)
void setRowWrapPolicy(QFormLayout::RowWrapPolicy policy)
void setVerticalSpacing(int spacing)
void setWidget(int row, QFormLayout::ItemRole role, QWidget *widget)
QFormLayout::TakeRowResult takeRow(int row)
QFormLayout::TakeRowResult takeRow(QLayout *layout)
QFormLayout::TakeRowResult takeRow(QWidget *widget)
int verticalSpacing() const

Funciones públicas reimplementadas

virtual void addItem(QLayoutItem *item) override
virtual int count() const override
virtual Qt::Orientations expandingDirections() const override
virtual bool hasHeightForWidth() const override
virtual int heightForWidth(int width) const override
virtual void invalidate() override
virtual QLayoutItem *itemAt(int index) const override
virtual QSize minimumSize() const override
virtual void setGeometry(const QRect &rect) override
virtual void setSpacing(int spacing) override
virtual QSize sizeHint() const override
virtual int spacing() const override
virtual QLayoutItem *takeAt(int index) override

Descripción detallada

QFormLayout es una clase de diseño práctica que distribuye sus elementos hijos en un formulario de dos columnas. La columna izquierda está formada por etiquetas y la derecha por widgets de «campo» (editores de línea, cuadros giratorios, etc.).

Tradicionalmente, estos diseños de formulario de dos columnas se conseguían utilizando ` QGridLayout`. `QFormLayout` es una alternativa de mayor nivel que ofrece las siguientes ventajas:

  • Cumplimiento de las directrices de apariencia de las distintas plataformas.

    Por ejemplo, las directrices de macOS Aqua y KDE especifican que las etiquetas deben estar alineadas a la derecha, mientras que las aplicaciones de Windows y GNOME suelen utilizar la alineación a la izquierda.

  • Compatibilidad con el ajuste de líneas largas.

    Para dispositivos con pantallas pequeñas, QFormLayout puede configurarse como « wrap long rows » o incluso como « wrap all rows ».

  • Cómoda API para crear pares de etiqueta y campo.

    La sobrecarga de addRow() que toma un QString y un QWidget * crea un QLabel en segundo plano y configura automáticamente su «compañero». Así, podemos escribir código como este:

    QFormLayout *formLayout = new QFormLayout(this);
    formLayout->addRow(tr("&Name:"), nameLineEdit);
    formLayout->addRow(tr("&Email:"), emailLineEdit);
    formLayout->addRow(tr("&Age:"), ageSpinBox);

    Compáralo con el siguiente código, escrito utilizando ` QGridLayout`:

    QGridLayout *gridLayout = new QGridLayout(this);
    
    nameLabel = new QLabel(tr("&Name:"));
    nameLabel->setBuddy(nameLineEdit);
    
    emailLabel = new QLabel(tr("&Name:"));
    emailLabel->setBuddy(emailLineEdit);
    
    ageLabel = new QLabel(tr("&Name:"));
    ageLabel->setBuddy(ageSpinBox);
    
    gridLayout->addWidget(nameLabel, 0, 0);
    gridLayout->addWidget(nameLineEdit, 0, 1);
    gridLayout->addWidget(emailLabel, 1, 0);
    gridLayout->addWidget(emailLineEdit, 1, 1);
    gridLayout->addWidget(ageLabel, 2, 0);
    gridLayout->addWidget(ageSpinBox, 2, 1);

La tabla siguiente muestra el aspecto predeterminado en diferentes estilos.

QCommonStyle estilos derivados (excepto QPlastiqueStyle)QMacStyleQPlastiqueStyleEstilos ampliados de Qt
Diseño de formulario al estilo tradicional de los ordenadores de sobremesaDiseño de formularios al estilo Aqua de macOSDiseño de formularios al estilo KDE PlastiqueDiseño de formularios al estilo de Qt Extended
Estilo tradicional utilizado para Windows, GNOME y versiones anteriores de KDE. Las etiquetas están alineadas a la izquierda y los campos expandibles crecen hasta ocupar todo el espacio disponible. (Esto suele corresponder a lo que obtendríamos utilizando un ` QGridLayout` de dos columnas.)Estilo basado en las directrices de Aqua de macOS. Las etiquetas están alineadas a la derecha, los campos no se expanden más allá de su tamaño indicado y el formulario está centrado horizontalmente.Estilo recomendado para aplicaciones KDE. Similar a MacStyle, salvo que el formulario está alineado a la izquierda y todos los campos se amplían para ocupar todo el espacio disponible.Estilo predeterminado para los estilos de Qt Extended. Las etiquetas están alineadas a la derecha, los campos que se expanden crecen hasta ocupar todo el espacio disponible y el ajuste de líneas está habilitado para las líneas largas.

Los estilos del formulario también se pueden anular individualmente llamando a ` setLabelAlignment()`, ` setFormAlignment()`, ` setFieldGrowthPolicy()` y ` setRowWrapPolicy()`. Por ejemplo, para simular el aspecto del diseño del formulario de `QMacStyle` en todas las plataformas, pero con etiquetas alineadas a la izquierda, se podría escribir:

formLayout->setRowWrapPolicy(QFormLayout::DontWrapRows);
formLayout->setFieldGrowthPolicy(QFormLayout::FieldsStayAtSizeHint);
formLayout->setFormAlignment(Qt::AlignHCenter | Qt::AlignTop);
formLayout->setLabelAlignment(Qt::AlignLeft);

Véase también QGridLayout, QBoxLayout y QStackedLayout.

Documentación sobre los tipos de miembros

enum QFormLayout::FieldGrowthPolicy

Esta enumeración especifica las diferentes políticas que se pueden utilizar para controlar la forma en que se amplían los campos del formulario.

ConstanteValorDescripción
QFormLayout::FieldsStayAtSizeHint0Los campos nunca se amplían más allá de su effective size hint. Este es el valor predeterminado para QMacStyle.
QFormLayout::ExpandingFieldsGrow1Los campos con una indicación de tamaño horizontal ( size policy ) de « Expanding » o « MinimumExpanding » se ampliarán hasta ocupar todo el espacio disponible. El resto de campos no se ampliarán más allá de su indicación de tamaño efectiva. Esta es la política predeterminada para Plastique.
QFormLayout::AllNonFixedFieldsGrow2Todos los campos con una política de tamaño que les permita expandirse se ampliarán hasta ocupar todo el espacio disponible. Esta es la política predeterminada para la mayoría de los estilos.

Véase también fieldGrowthPolicy.

enum QFormLayout::ItemRole

Esta enumeración especifica los tipos de widgets (u otros elementos de diseño) que pueden aparecer en una fila.

ConstanteValorDescripción
QFormLayout::LabelRole0Un widget de etiqueta.
QFormLayout::FieldRole1Un widget de campo.
QFormLayout::SpanningRole2Un widget que abarca las columnas de etiqueta y de campo.

Véase también itemAt() y getItemPosition().

enum QFormLayout::RowWrapPolicy

Esta enumeración especifica las diferentes políticas que se pueden utilizar para controlar la forma en que se ajustan las filas del formulario.

ConstanteValorDescripción
QFormLayout::DontWrapRows0Los campos siempre se disponen junto a su etiqueta. Esta es la política predeterminada para todos los estilos, excepto los de Qt Extended.
QFormLayout::WrapLongRows1Se asigna a las etiquetas el espacio horizontal suficiente para que quepa la etiqueta más ancha, y el espacio restante se destina a los campos. Si el tamaño mínimo de un par de campos es mayor que el espacio disponible, el campo pasa a la línea siguiente. Esta es la política predeterminada para los estilos Qt Extended.
QFormLayout::WrapAllRows2Los campos siempre se disponen debajo de su etiqueta.

Véase también « rowWrapPolicy ».

Documentación de propiedades

fieldGrowthPolicy : FieldGrowthPolicy

Esta propiedad determina la forma en que se amplían los campos del formulario

El valor por defecto depende del estilo del widget o de la aplicación. Para QMacStyle, el valor por defecto es « FieldsStayAtSizeHint »; para los estilos derivados de « QCommonStyle » (como «Plastique» y «Windows»), el valor por defecto es « ExpandingFieldsGrow »; para los estilos de Qt Extended, el valor por defecto es « AllNonFixedFieldsGrow ».

Si ninguno de los campos puede ampliarse y se cambia el tamaño del formulario, el espacio adicional se distribuye según el valor actual de form alignment.

Funciones de acceso:

QFormLayout::FieldGrowthPolicy fieldGrowthPolicy() const
void setFieldGrowthPolicy(QFormLayout::FieldGrowthPolicy policy)

Véase también formAlignment y rowWrapPolicy.

formAlignment : Qt::Alignment

Esta propiedad determina la alineación del contenido del diseño del formulario dentro de la geometría del diseño

El valor por defecto depende del estilo del widget o de la aplicación. Para QMacStyle, el valor por defecto es Qt::AlignHCenter | Qt::AlignTop; para los demás estilos, el valor por defecto es Qt::AlignLeft | Qt::AlignTop.

Funciones de acceso:

Qt::Alignment formAlignment() const
void setFormAlignment(Qt::Alignment alignment)

Véase también labelAlignment y rowWrapPolicy.

horizontalSpacing : int

Esta propiedad determina el espaciado entre los widgets dispuestos uno al lado del otro

Por defecto, si no se establece ningún valor explícitamente, el espaciado horizontal del diseño se hereda del diseño padre o de la configuración de estilo del widget padre.

Funciones de acceso:

int horizontalSpacing() const
void setHorizontalSpacing(int spacing)

Véase también verticalSpacing, QStyle::pixelMetric() y PM_LayoutHorizontalSpacing.

labelAlignment : Qt::Alignment

Esta propiedad determina la alineación horizontal de las etiquetas

El valor por defecto depende del widget o del estilo de la aplicación. Para los estilos derivados de « QCommonStyle », excepto «QPlastiqueStyle», el valor por defecto es « Qt::AlignLeft »; para los demás estilos, el valor por defecto es « Qt::AlignRight ».

Funciones de acceso:

Qt::Alignment labelAlignment() const
void setLabelAlignment(Qt::Alignment alignment)

Véase también formAlignment.

rowWrapPolicy : RowWrapPolicy

Esta propiedad determina la forma en que se ajustan las filas del formulario

El valor por defecto depende del estilo del widget o de la aplicación. Para los estilos de Qt Extended, el valor por defecto es « WrapLongRows »; para los demás estilos, el valor por defecto es « DontWrapRows ».

Si deseas que cada etiqueta se muestre encima de su campo asociado (en lugar de junto a él), establece esta propiedad en « WrapAllRows ».

Funciones de acceso:

QFormLayout::RowWrapPolicy rowWrapPolicy() const
void setRowWrapPolicy(QFormLayout::RowWrapPolicy policy)

Véase también fieldGrowthPolicy.

verticalSpacing : int

Esta propiedad define el espaciado entre los widgets dispuestos verticalmente

Por defecto, si no se establece ningún valor explícitamente, el espaciado vertical del diseño se hereda del diseño padre o de la configuración de estilo del widget padre.

Funciones de acceso:

int verticalSpacing() const
void setVerticalSpacing(int spacing)

Véase también horizontalSpacing, QStyle::pixelMetric() y PM_LayoutHorizontalSpacing.

Documentación de funciones de miembro

[explicit] QFormLayout::QFormLayout(QWidget *parent = nullptr)

Crea un nuevo diseño de formulario con el widget « parent » especificado.

El diseño se establece directamente como el diseño de nivel superior para parent. Solo puede haber un diseño de nivel superior para un widget. Se devuelve mediante QWidget::layout().

Véase también QWidget::setLayout().

[virtual noexcept] QFormLayout::~QFormLayout()

Alterar la disposición del formulario.

[override virtual] void QFormLayout::addItem(QLayoutItem *item)

Reimplementa: QLayout::addItem(QLayoutItem *item).

void QFormLayout::addRow(QWidget *label, QWidget *field)

Añade una nueva fila al final de este diseño de formulario, con los valores indicados en « label » y « field ».

Véase también insertRow().

void QFormLayout::addRow(QLayout *layout)

Añade el elemento « layout » especificado al final del diseño de este formulario. El elemento « layout » ocupa ambas columnas.

Esta es una función sobrecargada.

void QFormLayout::addRow(QWidget *widget)

Añade el « widget » especificado al final del diseño de este formulario. El « widget » ocupa ambas columnas.

Esta es una función sobrecargada.

void QFormLayout::addRow(QWidget *label, QLayout *field)

Esta es una función sobrecargada.

void QFormLayout::addRow(const QString &labelText, QLayout *field)

Esta sobrecarga crea automáticamente, en segundo plano, un ` QLabel ` con el texto ` labelText `.

Se trata de una función sobrecargada.

void QFormLayout::addRow(const QString &labelText, QWidget *field)

Esta sobrecarga crea automáticamente, en segundo plano, una ` QLabel ` con el texto ` labelText `. El ` field ` se establece como el ` buddy` del nuevo ` QLabel`.

Se trata de una función sobrecargada.

[override virtual] int QFormLayout::count() const

Reimplementa: ` QLayout::count()` const.

[override virtual] Qt::Orientations QFormLayout::expandingDirections() const

Reimplementa: QLayout::expandingDirections() const.

void QFormLayout::getItemPosition(int index, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Recupera la fila y la función (columna) del elemento en la dirección especificada index. Si index está fuera de límites, *rowPtr se establece en -1; en caso contrario, la fila se almacena en *rowPtr y la función se almacena en *rolePtr.

Véase también itemAt(), count(), getLayoutPosition() y getWidgetPosition().

void QFormLayout::getLayoutPosition(QLayout *layout, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Recupera la fila y la función (columna) del elemento secundario especificado layout. Si layout no se encuentra en el diseño del formulario, *rowPtr se establece en -1; en caso contrario, la fila se almacena en *rowPtr y la función se almacena en *rolePtr.

void QFormLayout::getWidgetPosition(QWidget *widget, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Recupera la fila y la función (columna) del elemento « widget » especificado en el diseño. Si « widget » no se encuentra en el diseño, se asigna el valor -1 a «*rowPtr »; en caso contrario, la fila se almacena en «*rowPtr » y la función se almacena en «*rolePtr ».

Véase también « getItemPosition()» y « itemAt()».

[override virtual] bool QFormLayout::hasHeightForWidth() const

Reimplementa: ` QLayoutItem::hasHeightForWidth()` const.

[override virtual] int QFormLayout::heightForWidth(int width) const

Reimplementa: ` QLayoutItem::heightForWidth(int) const`.

void QFormLayout::insertRow(int row, QWidget *label, QWidget *field)

Inserta una nueva fila en la posición row en este diseño de formulario, con los valores label y field indicados. Si row está fuera de los límites, la nueva fila se añade al final.

Véase también addRow().

void QFormLayout::insertRow(int row, QLayout *layout)

Inserta el elemento « layout » especificado en la posición « row » de este diseño de formulario. El elemento « layout » abarca ambas columnas. Si « row » se sale de los límites, el widget se añade al final.

Esta es una función sobrecargada.

void QFormLayout::insertRow(int row, QWidget *widget)

Inserta el elemento « widget » especificado en la posición « row » de este diseño de formulario. El elemento « widget » abarca ambas columnas. Si « row » se sale de los límites, el widget se añade al final.

Esta es una función sobrecargada.

void QFormLayout::insertRow(int row, QWidget *label, QLayout *field)

Esta es una función sobrecargada.

void QFormLayout::insertRow(int row, const QString &labelText, QLayout *field)

Esta sobrecarga crea automáticamente, en segundo plano, un objeto ` QLabel ` con el texto ` labelText `.

Se trata de una función sobrecargada.

void QFormLayout::insertRow(int row, const QString &labelText, QWidget *field)

Esta sobrecarga crea automáticamente, en segundo plano, un objeto ` QLabel ` con el texto ` labelText `. El ` field ` se establece como el ` buddy` del nuevo ` QLabel`.

Se trata de una función sobrecargada.

[override virtual] void QFormLayout::invalidate()

Reimplementa: QLayout::invalidate().

[since 6.4] bool QFormLayout::isRowVisible(int row) const

Devuelve «true» si algunos elementos de la fila row están visibles; en caso contrario, devuelve «false».

Esta función se introdujo en Qt 6.4.

[since 6.4] bool QFormLayout::isRowVisible(QLayout *layout) const

Devuelve «true» si algunos elementos de la fila correspondiente a layout están visibles; en caso contrario, devuelve «false».

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.4.

[since 6.4] bool QFormLayout::isRowVisible(QWidget *widget) const

Devuelve «true» si algunos elementos de la fila correspondiente a widget están visibles; en caso contrario, devuelve «false».

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.4.

[override virtual] QLayoutItem *QFormLayout::itemAt(int index) const

Reimplementa: ` QLayout::itemAt(int index) const`.

QLayoutItem *QFormLayout::itemAt(int row, QFormLayout::ItemRole role) const

Devuelve el elemento de diseño del « row » indicado con el « role » (columna) especificado. Devuelve « nullptr » si no existe dicho elemento.

Véase también QLayout::itemAt() y setItem().

QWidget *QFormLayout::labelForField(QWidget *field) const

Devuelve la etiqueta asociada al « field » indicado.

Véase también itemAt().

QWidget *QFormLayout::labelForField(QLayout *field) const

Esta es una función sobrecargada.

[override virtual] QSize QFormLayout::minimumSize() const

Reimplementa: QLayout::minimumSize() const.

void QFormLayout::removeRow(int row)

Elimina la fila « row » de este diseño de formulario.

row Debe ser un número no negativo y menor que rowCount().

Tras esta llamada, rowCount() se decrementa en uno. Se eliminan todos los widgets y diseños anidados que ocupaban esta fila. Esto incluye tanto los widgets de campo como la etiqueta, si la hubiera. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

Puedes utilizar esta función para deshacer una llamada previa a ` addRow()` o ` insertRow()`:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(2); // le == nullptr at this point

Si deseas eliminar la fila del diseño sin borrar los widgets, utiliza en su lugar takeRow().

Véase también takeRow().

void QFormLayout::removeRow(QLayout *layout)

Elimina la fila correspondiente a layout de este diseño de formulario.

Tras esta llamada, el valor de ` rowCount()` se reduce en uno. Se eliminan todos los widgets y diseños anidados que ocupaban esta fila. Esto incluye tanto los widgets de campo como la etiqueta, si la hubiera. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

Puedes utilizar esta función para deshacer una llamada previa a addRow() o insertRow():

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
flay->removeRow(layout); // vbl == nullptr at this point

Si deseas eliminar la fila del diseño del formulario sin borrar el diseño insertado, utiliza en su lugar takeRow().

Esta es una función sobrecargada.

Véase también takeRow().

void QFormLayout::removeRow(QWidget *widget)

Elimina la fila correspondiente a widget de este diseño de formulario.

Tras esta llamada, el valor de rowCount() se reduce en uno. Se eliminan todos los widgets y diseños anidados que ocupaban esta fila. Esto incluye tanto los widgets de campo como la etiqueta, si la hubiera. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

Puedes utilizar esta función para deshacer una llamada previa a addRow() o insertRow():

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(le); // le == nullptr at this point

Si quieres eliminar la fila del diseño sin borrar los widgets, utiliza en su lugar takeRow().

Esta es una función sobrecargada.

Véase también takeRow().

int QFormLayout::rowCount() const

Devuelve el número de filas del formulario.

Véase también QLayout::count().

[override virtual] void QFormLayout::setGeometry(const QRect &rect)

Reimplementa: QLayout::setGeometry(const QRect &r).

void QFormLayout::setItem(int row, QFormLayout::ItemRole role, QLayoutItem *item)

Establece el elemento de la row indicada para el role especificado en item, ampliando la disposición con filas vacías si es necesario.

Si la celda ya está ocupada, el elemento « item » no se inserta y se envía un mensaje de error a la consola. El elemento « item » abarca ambas columnas.

Advertencia: No utilices esta función para añadir diseños secundarios o elementos de widget secundarios. Utiliza en su lugar setLayout() o setWidget().

Véase también setLayout().

void QFormLayout::setLayout(int row, QFormLayout::ItemRole role, QLayout *layout)

Establece el subdiseño en el « row » indicado para el « role » especificado como « layout », ampliando el diseño del formulario con filas vacías si es necesario.

Si la celda ya está ocupada, no se inserta el layout y se envía un mensaje de error a la consola.

Nota: Para la mayoría de las aplicaciones, se debe utilizar ` addRow()` o ` insertRow()` en lugar de `setLayout()`.

Véase también ` setWidget()`.

[since 6.4] void QFormLayout::setRowVisible(int row, bool on)

Muestra la fila row si on es verdadero; en caso contrario, oculta la fila.

row Debe ser un número no negativo y menor que rowCount().

Esta función se introdujo en Qt 6.4.

Véanse también isRowVisible(), removeRow() y takeRow().

[since 6.4] void QFormLayout::setRowVisible(QLayout *layout, bool on)

Muestra la fila correspondiente a layout si on es verdadero; en caso contrario, oculta la fila.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.4.

Véase también removeRow() y takeRow().

[since 6.4] void QFormLayout::setRowVisible(QWidget *widget, bool on)

Muestra la fila correspondiente a widget si on es verdadero; en caso contrario, oculta la fila.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.4.

Véanse también removeRow() y takeRow().

[override virtual] void QFormLayout::setSpacing(int spacing)

Reimplementa una función de acceso para la propiedad: QLayout::spacing.

Esta función establece tanto el espaciado vertical como el horizontal en ` spacing`.

Véase también spacing(), setVerticalSpacing() y setHorizontalSpacing().

void QFormLayout::setWidget(int row, QFormLayout::ItemRole role, QWidget *widget)

Establece el widget en el « row » indicado para el « role » especificado en « widget », ampliando el diseño con filas vacías si es necesario.

Si la celda ya está ocupada, no se inserta el widget y se envía un mensaje de error a la consola.

Nota: Para la mayoría de las aplicaciones, se debe utilizar addRow() o insertRow() en lugar de setWidget().

Véase también ` setLayout()`.

[override virtual] QSize QFormLayout::sizeHint() const

Reimplementa: ` QLayoutItem::sizeHint()` const.

[override virtual] int QFormLayout::spacing() const

Reimplementa una función de acceso para la propiedad: QLayout::spacing.

Si el espaciado vertical es igual al espaciado horizontal, esta función devuelve ese valor; en caso contrario, devuelve -1.

Véase también setSpacing(), verticalSpacing() y horizontalSpacing().

[override virtual] QLayoutItem *QFormLayout::takeAt(int index)

Reimplementa: ` QLayout::takeAt(int index)`.

QFormLayout::TakeRowResult QFormLayout::takeRow(int row)

Elimina el « row » especificado de este diseño de formulario.

row Debe ser un número no negativo y menor que rowCount().

Nota: Esta función no elimina nada.

Tras esta llamada, el valor de ` rowCount()` se reduce en uno. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

Puedes utilizar esta función para deshacer una llamada anterior a ` addRow()` o ` insertRow()`:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(2);

Si desea eliminar la fila del diseño y borrar los widgets, utilice en su lugar removeRow().

Devuelve una estructura que contiene tanto el widget como los elementos de diseño de la etiqueta correspondiente

Véase también removeRow().

QFormLayout::TakeRowResult QFormLayout::takeRow(QLayout *layout)

Elimina el « layout » especificado de este diseño de formulario.

Nota: Esta función no elimina nada.

Tras esta llamada, el valor de ` rowCount()` se reduce en uno. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

Si deseas eliminar la fila del diseño del formulario y borrar el diseño insertado, utiliza en su lugar removeRow().

Devuelve una estructura que contiene tanto el widget como los elementos de diseño de la etiqueta correspondiente

Esta es una función sobrecargada.

Véase también removeRow().

QFormLayout::TakeRowResult QFormLayout::takeRow(QWidget *widget)

Elimina el « widget » especificado de este diseño de formulario.

Nota: Esta función no elimina nada.

Tras esta llamada, el valor de « rowCount()» se reduce en uno. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

Si deseas eliminar la fila del diseño y borrar los widgets, utiliza en su lugar removeRow().

Devuelve una estructura que contiene tanto el widget como los elementos de diseño de la etiqueta correspondiente

Esta es una función sobrecargada.

Véase también ` removeRow()`.

© 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.