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) | QMacStyle | QPlastiqueStyle | Estilos ampliados de Qt |
|---|---|---|---|
![]() | ![]() | ![]() | ![]() |
| 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.
| Constante | Valor | Descripción |
|---|---|---|
QFormLayout::FieldsStayAtSizeHint | 0 | Los campos nunca se amplían más allá de su effective size hint. Este es el valor predeterminado para QMacStyle. |
QFormLayout::ExpandingFieldsGrow | 1 | Los 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::AllNonFixedFieldsGrow | 2 | Todos 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.
| Constante | Valor | Descripción |
|---|---|---|
QFormLayout::LabelRole | 0 | Un widget de etiqueta. |
QFormLayout::FieldRole | 1 | Un widget de campo. |
QFormLayout::SpanningRole | 2 | Un 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.
| Constante | Valor | Descripción |
|---|---|---|
QFormLayout::DontWrapRows | 0 | Los campos siempre se disponen junto a su etiqueta. Esta es la política predeterminada para todos los estilos, excepto los de Qt Extended. |
QFormLayout::WrapLongRows | 1 | Se 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::WrapAllRows | 2 | Los 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 pointSi 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 pointSi 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 pointSi 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.



