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 *item)을 재구현합니다.

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)

지정된 ` layout `를 이 양식 레이아웃의 ` row ` 위치에 삽입합니다. ` layout `는 두 열에 걸쳐 표시됩니다. ` row `가 허용 범위를 벗어날 경우, 위젯은 끝 부분에 추가됩니다.

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

지정된 ` widget `를 이 양식 레이아웃의 ` row ` 위치에 삽입합니다. ` 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 행에 표시된 항목이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

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

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

layout 에 해당하는 행의 항목 중 일부가 표시되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

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

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

widget 에 해당하는 행의 항목 중 일부가 표시되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

이 함수는 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

지정된 row 내에서 지정된 role (열)에 해당하는 레이아웃 항목을 반환합니다. 해당 항목이 없는 경우 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 값은 0 이상이어야 하며 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 값은 0 이상이어야 하며 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 가 true인 경우 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 값은 0 이상이어야 하며 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()도 참조하십시오 .