QFormLayout Class

Documentación de las funciones miembro

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

Construye un nuevo diseño de formulario con el widget parent dado.

El diseño se establece directamente como el diseño de nivel superior para parent. Sólo puede haber un diseño de nivel superior para un widget. Es devuelto por QWidget::layout().

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

[virtual noexcept] QFormLayout::~QFormLayout()

Destruye el diseño 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 en la parte inferior del formulario, con las direcciones label y field.

Véase también insertRow().

void QFormLayout::addRow(QLayout *layout)

Añade el layout especificado al final de este diseño de formulario. El layout abarca ambas columnas.

void QFormLayout::addRow(QWidget *widget)

Añade el widget especificado al final de este diseño de formulario. El widget abarca ambas columnas.

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

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

Esta sobrecarga crea automáticamente un QLabel entre bastidores con labelText como texto.

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

Esta sobrecarga crea automáticamente un QLabel entre bastidores con labelText como texto. El field se establece como el nuevo QLabel's buddy.

[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 el rol (columna) del elemento en el index especificado . Si index está fuera de los límites, *rowPtr se establece en -1; de lo contrario, la fila se almacena en *rowPtr y el rol 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 el rol (columna) del hijo especificado layout. Si layout no está en el diseño del formulario, *rowPtr se establece en -1; de lo contrario, la fila se almacena en *rowPtr y el rol se almacena en *rolePtr.

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

Recupera la fila y el rol (columna) del widget especificado en la presentación. Si widget no está en la presentación, *rowPtr se establece en -1; de lo contrario, la fila se almacena en *rowPtr y el rol 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 dados label y field. 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 layout especificado en la posición row en este diseño de formulario. layout abarca ambas columnas. Si row está fuera de los límites, el widget se añade al final.

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

Inserta el widget especificado en la posición row en este diseño de formulario. widget abarca ambas columnas. Si row está fuera de los límites, el widget se añade al final.

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

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

Esta sobrecarga crea automáticamente un QLabel entre bastidores con labelText como texto.

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

Esta sobrecarga crea automáticamente un QLabel entre bastidores con labelText como texto. El field se establece como el nuevo QLabel's buddy.

[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 son 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 son visibles, en caso contrario devuelve false.

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 son visibles, en caso contrario devuelve false.

Esta función se introdujo en Qt 6.4.

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

Reimplementa: QLayout::itemAt(int índice) const.

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

Devuelve el elemento de diseño en el row dado con el role especificado (columna). Devuelve nullptr si no existe tal elemento.

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

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

Devuelve la etiqueta asociada a la dirección field.

Véase también itemAt().

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

[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 no negativo y menor que rowCount().

Después de esta llamada, rowCount() se decrementa en uno. Todos los widgets y diseños anidados que ocupaban esta fila son eliminados. Esto incluye tanto el widget(s) 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.

Puede utilizar esta función para deshacer una operación anterior de 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 desea eliminar la fila del diseño sin borrar los widgets, utilice takeRow() en su lugar.

Véase también takeRow().

void QFormLayout::removeRow(QLayout *layout)

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

Después de esta llamada, rowCount() se decrementa en uno. Todos los widgets y diseños anidados que ocupaban esta fila son eliminados. Esto incluye tanto el widget(s) 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.

Puede utilizar esta función para deshacer una operación anterior de 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 desea eliminar la fila del diseño del formulario sin borrar el diseño insertado, utilice takeRow() en su lugar.

Véase también takeRow().

void QFormLayout::removeRow(QWidget *widget)

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

Después de esta llamada, rowCount() se decrementa en uno. Todos los widgets y diseños anidados que ocupaban esta fila son eliminados. Esto incluye tanto el widget(s) 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.

Puede utilizar esta función para deshacer una operación anterior de 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 desea eliminar la fila del diseño sin borrar los widgets, utilice takeRow() en su lugar.

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 en el row dado para el role dado en item, ampliando el diseño con filas vacías si es necesario.

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

Véase también setLayout().

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

Establece el sub-diseño en el row dado para el role dado a layout, extendiendo el diseño del formulario con filas vacías si es necesario.

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

Nota: Para la mayoría de las aplicaciones, debería utilizarse 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 no negativo y menor que rowCount().

Esta función se introdujo en Qt 6.4.

Véase 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 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 función se introdujo en Qt 6.4.

Véase 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 dado para el role dado a widget, extendiendo el diseño con filas vacías si es necesario.

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

Nota: Para la mayoría de las aplicaciones, debería utilizarse 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 a la propiedad: QLayout::spacing.

Si el espaciado vertical es igual al 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 índice).

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

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

row debe ser no negativo y menor que rowCount().

Después de esta llamada, rowCount() se decrementa en uno. Todas las filas siguientes se desplazan una fila hacia arriba y el espacio vertical liberado se redistribuye entre las filas restantes.

Puede 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 removeRow() en su lugar.

Devuelve Una estructura que contiene tanto el widget como los elementos correspondientes de la etiqueta.

Véase también removeRow().

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

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

Después de esta llamada, rowCount() se decrementa 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 desea eliminar la fila del diseño del formulario y borrar el diseño insertado, utilice removeRow() en su lugar.

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(QWidget *widget)

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

Después de esta llamada, rowCount() se decrementa 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 desea eliminar la fila del diseño y borrar los widgets, utilice removeRow() en su lugar.

Devuelve Una estructura que contiene tanto el widget como los elementos correspondientes de la etiqueta.

Véase también removeRow().