QFormLayout Class

멤버 함수 문서

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

주어진 parent 위젯으로 새 양식 레이아웃을 구성합니다.

이 레이아웃은 parent 의 최상위 레이아웃으로 직접 설정됩니다. 위젯에 대한 최상위 레이아웃은 하나만 있을 수 있습니다. QWidget::layout ()에 의해 반환됩니다.

QWidget::setLayout()도 참조하세요 .

[virtual noexcept] QFormLayout::~QFormLayout()

양식 레이아웃을 삭제합니다.

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

다시 구현합니다: QLayout::addItem(QLayoutItem *항목).

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

지정된 label 및 field 을 사용하여 이 양식 레이아웃의 하단에 새 행을 추가합니다.

insertRow()도 참조하세요 .

void QFormLayout::addRow(QLayout *layout)

이 함수는 과부하된 함수입니다.

이 양식 레이아웃의 끝에 지정된 layout 을 추가합니다. layout 은 두 열에 걸쳐 있습니다.

void QFormLayout::addRow(QWidget *widget)

이 함수는 과부하된 함수입니다.

이 양식 레이아웃의 끝에 지정된 widget 을 추가합니다. widget 은 두 열에 걸쳐 있습니다.

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

과부하가 걸린 기능입니다.

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

이 함수는 과부하가 걸린 함수입니다.

이 과부하가 발생하면 백그라운드에서 labelText 을 텍스트로 하는 QLabel 이 자동으로 생성됩니다.

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

이 함수는 과부하가 걸린 함수입니다.

이 과부하로 인해 백그라운드에서 labelText 을 텍스트로 하는 QLabel 이 자동으로 생성됩니다. field 은 새로운 QLabel 의 buddy 로 설정됩니다.

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

재구현합니다: QLayout::count() const.

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

재구현합니다: QLayout::expandingDirections() const.

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

지정된 index 에서 항목의 행과 역할(열)을 검색합니다. index 이 범위를 벗어난 경우 *rowPtr 은 -1로 설정되고, 그렇지 않으면 행은 *rowPtr 에 저장되고 역할은 *rolePtr 에 저장됩니다.

itemAt(), count(), getLayoutPosition() 및 getWidgetPosition()도 참조하세요 .

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

지정된 자식의 행과 역할(열)을 검색합니다 layout. layout 이 양식 레이아웃에 없으면 *rowPtr 이 -1로 설정되고, 그렇지 않으면 행은 *rowPtr 에 저장되고 역할은 *rolePtr 에 저장됩니다.

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

레이아웃에서 지정된 widget 의 행과 역할(열)을 검색합니다. widget 가 레이아웃에 없으면 *rowPtr 은 -1로 설정되고, 그렇지 않으면 행은 *rowPtr 에 저장되고 역할은 *rolePtr 에 저장됩니다.

getItemPosition() 및 itemAt()도 참조하세요 .

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

재구현합니다: QLayoutItem::hasHeightForWidth() const.

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

재구현합니다: QLayoutItem::heightForWidth(int) const.

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

이 양식 레이아웃의 row 위치에 지정된 label 및 field 과 함께 새 행을 삽입합니다. row 이 범위를 벗어난 경우 새 행이 끝에 추가됩니다.

addRow()도 참조하세요 .

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

이 함수는 과부하된 함수입니다.

이 양식 레이아웃의 row 위치에 지정된 layout 을 삽입합니다. layout 은 두 열에 걸쳐 있습니다. row 가 범위를 벗어나는 경우 위젯이 끝에 추가됩니다.

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

이 함수는 과부하된 함수입니다.

이 양식 레이아웃의 row 위치에 지정된 widget 을 삽입합니다. widget 은 두 열에 걸쳐 있습니다. row 가 범위를 벗어난 경우 위젯이 끝에 추가됩니다.

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

과부하가 걸린 기능입니다.

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

이 함수는 과부하가 걸린 함수입니다.

이 과부하가 발생하면 백그라운드에서 labelText 을 텍스트로 하는 QLabel 이 자동으로 생성됩니다.

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

이 함수는 과부하가 걸린 함수입니다.

이 과부하로 인해 백그라운드에서 자동으로 labelText 을 텍스트로 하는 QLabel 이 생성됩니다. field 은 새로운 QLabel 의 buddy 로 설정됩니다.

[override virtual] void QFormLayout::invalidate()

다시 구현합니다: QLayout::invalidate().

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

row 행의 일부 항목이 표시되면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

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

이 함수는 오버로드된 함수입니다.

layout 에 해당하는 행의 일부 항목이 표시되면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

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

이 함수는 오버로드된 함수입니다.

widget 에 해당하는 행의 일부 항목이 표시되면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

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

재구현합니다: QLayout::itemAt(int index) const.

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

지정된 role (열)이 있는 지정된 row 의 레이아웃 항목을 반환합니다. 해당 항목이 없으면 nullptr 을 반환합니다.

QLayout::itemAt() 및 setItem()도 참조하세요 .

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

주어진 field 과 연관된 레이블을 반환합니다.

itemAt()도 참조하세요 .

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

과부하가 걸린 기능입니다.

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

재구현합니다: QLayout::minimumSize() const.

void QFormLayout::removeRow(int row)

이 양식 레이아웃에서 row 행을 삭제합니다.

row 는 음수가 아니며 rowCount()보다 작아야 합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 이 행을 차지했던 모든 위젯과 중첩된 레이아웃이 삭제됩니다. 여기에는 필드 위젯과 레이블(있는 경우)이 모두 포함됩니다. 다음 행은 모두 한 행 위로 이동하고 확보된 세로 공간은 나머지 행에 재분배됩니다.

이 함수를 사용하여 이전 addRow() 또는 insertRow()을 실행 취소할 수 있습니다:

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

위젯을 삭제하지 않고 레이아웃에서 행을 제거하려면 takeRow()를 대신 사용하세요.

takeRow()도 참조하세요 .

void QFormLayout::removeRow(QLayout *layout)

이 함수는 과부하된 함수입니다.

이 양식 레이아웃에서 layout 에 해당하는 행을 삭제합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 이 행을 차지했던 모든 위젯과 중첩된 레이아웃이 삭제됩니다. 여기에는 필드 위젯과 레이블(있는 경우)이 모두 포함됩니다. 다음 행은 모두 한 행 위로 이동하고 확보된 세로 공간은 나머지 행에 재분배됩니다.

이 함수를 사용하여 이전 addRow() 또는 insertRow()을 실행 취소할 수 있습니다:

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

삽입된 레이아웃을 삭제하지 않고 양식 레이아웃에서 행을 제거하려면 takeRow()를 대신 사용하세요.

takeRow()도 참조하세요 .

void QFormLayout::removeRow(QWidget *widget)

이 함수는 과부하된 함수입니다.

이 양식 레이아웃에서 widget 에 해당하는 행을 삭제합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 이 행을 차지했던 모든 위젯과 중첩된 레이아웃이 삭제됩니다. 여기에는 필드 위젯과 레이블(있는 경우)이 모두 포함됩니다. 다음 행은 모두 한 행 위로 이동하고 확보된 세로 공간은 나머지 행에 재분배됩니다.

이 함수를 사용하여 이전 addRow() 또는 insertRow()을 실행 취소할 수 있습니다:

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

위젯을 삭제하지 않고 레이아웃에서 행을 제거하려면 takeRow()를 대신 사용하세요.

takeRow()도 참조하세요 .

int QFormLayout::rowCount() const

양식의 행 수를 반환합니다.

QLayout::count()도 참조하세요 .

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

재구현합니다: QLayout::setGeometry(const QRect &r).

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

주어진 role 에 대해 주어진 row 의 항목을 item 로 설정하고 필요한 경우 빈 행으로 레이아웃을 확장합니다.

셀이 이미 사용 중인 경우 item 이 삽입되지 않고 오류 메시지가 콘솔로 전송됩니다. item 은 두 열에 걸쳐 있습니다.

setLayout()도 참조하세요 .

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

지정된 role 에 대한 지정된 row 의 하위 레이아웃을 layout 로 설정하고 필요한 경우 빈 행으로 양식 레이아웃을 확장합니다.

셀이 이미 사용 중인 경우 layout 이 삽입되지 않고 오류 메시지가 콘솔로 전송됩니다.

참고: 대부분의 애플리케이션에서는 setLayout() 대신 addRow() 또는 insertRow()을 사용해야 합니다.

setWidget()도 참조하세요 .

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

on 이 참이면 row 행을 표시하고, 그렇지 않으면 행을 숨깁니다.

row 는 음수가 아니며 rowCount()보다 작아야 합니다.

이 함수는 Qt 6.4에 도입되었습니다.

isRowVisible(), removeRow() 및 takeRow()도 참조하십시오 .

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

이 함수는 오버로드된 함수입니다.

on 이 참이면 layout 에 해당하는 행을 표시하고, 그렇지 않으면 행을 숨깁니다.

이 함수는 Qt 6.4에 도입되었습니다.

removeRow() 및 takeRow()도 참조하십시오 .

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

이 함수는 오버로드된 함수입니다.

on 이 참이면 widget 에 해당하는 행을 표시하고, 그렇지 않으면 행을 숨깁니다.

이 함수는 Qt 6.4에 도입되었습니다.

removeRow() 및 takeRow()도 참조하십시오 .

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

속성에 대한 액세스 함수를 다시 구현합니다: QLayout::spacing.

이 함수는 수직 및 수평 간격을 모두 spacing 로 설정합니다.

spacing(), setVerticalSpacing() 및 setHorizontalSpacing()도 참조하세요 .

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

주어진 role 에 대해 주어진 row 의 위젯을 widget 로 설정하고 필요한 경우 빈 행으로 레이아웃을 확장합니다.

셀이 이미 사용 중이면 widget 이 삽입되지 않고 오류 메시지가 콘솔로 전송됩니다.

참고: 대부분의 애플리케이션에서는 setWidget() 대신 addRow() 또는 insertRow()을 사용해야 합니다.

setLayout()도 참조하세요 .

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

재구현합니다: QLayoutItem::sizeHint() const.

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

속성에 대한 액세스 함수를 다시 구현합니다: QLayout::spacing.

수직 간격이 수평 간격과 같으면 이 함수는 해당 값을 반환하고, 그렇지 않으면 -1을 반환합니다.

setSpacing(), verticalSpacing() 및 horizontalSpacing()도 참조하세요 .

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

재구현합니다: QLayout::takeAt(int index).

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

이 양식 레이아웃에서 지정된 row 을 제거합니다.

row 는 음수가 아니며 rowCount()보다 작아야 합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 다음 모든 행이 한 행 위로 이동하고 확보된 세로 공간이 나머지 행에 재분배됩니다.

이 함수를 사용하여 이전 addRow() 또는 insertRow() 실행을 취소할 수 있습니다:

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

레이아웃에서 행을 제거하고 위젯을 삭제하려면 removeRow()를 대신 사용하세요.

위젯과 해당 레이블 레이아웃 항목을 모두 포함하는 구조를 반환합니다.

removeRow()도 참조하세요 .

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

이 함수는 과부하된 함수입니다.

이 양식 레이아웃에서 지정된 layout 을 제거합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 다음 행은 모두 한 행 위로 이동하고 확보된 세로 공간은 나머지 행에 재분배됩니다.

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

양식 레이아웃에서 행을 제거하고 삽입된 레이아웃을 삭제하려면 removeRow()를 대신 사용합니다.

위젯과 해당 레이블 레이아웃 항목을 모두 포함하는 구조를 반환합니다.

removeRow()도 참조하세요 .

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

이 함수는 과부하된 함수입니다.

이 양식 레이아웃에서 지정된 widget 을 제거합니다.

이 호출 후에는 rowCount()가 1씩 감소합니다. 다음 행은 모두 한 행 위로 이동하고 확보된 세로 공간은 나머지 행에 재분배됩니다.

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

레이아웃에서 행을 제거하고 위젯을 삭제하려면 removeRow()를 대신 사용합니다.

위젯과 해당 레이블 레이아웃 항목을 모두 포함하는 구조를 반환합니다.

removeRow()도 참조하세요 .