QGridLayout Class

멤버 함수 문서

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

부모 위젯인 ` parent`을 사용하여 새로운 `QGridLayout`을 생성합니다. 이 레이아웃은 처음에 행 하나와 열 하나로 구성되며, 새로운 항목이 삽입되면 확장됩니다.

이 레이아웃은 ` parent`의 최상위 레이아웃으로 직접 설정됩니다. 위젯당 최상위 레이아웃은 하나만 가질 수 있습니다. 이는 ` QWidget::layout()` 메서드에 의해 반환됩니다.

parent 가 nullptr 인 경우, 이 그리드 레이아웃을 다른 레이아웃에 삽입하거나 QWidget::setLayout()를 사용하여 위젯의 레이아웃으로 설정해야 합니다.

QWidget::setLayout()도 참조하십시오 .

[virtual noexcept] QGridLayout::~QGridLayout()

그리드 레이아웃을 제거합니다. 이 그리드가 최상위 그리드인 경우, 기하 구조 관리가 종료됩니다.

레이아웃의 위젯은 파괴되지 않습니다.

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

QLayout::addItem(QLayoutItem *item)을 재구현합니다.

void QGridLayout::addItem(QLayoutItem *item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment alignment = Qt::Alignment())

row, column 위치에 item 를 추가하며, rowSpan 행과 columnSpan 열을 차지하고, alignment 에 따라 정렬합니다. rowSpan 및/또는 columnSpan 가 -1인 경우, 해당 항목은 각각 하단 및/또는 오른쪽 가장자리까지 확장됩니다. 이 레이아웃은 item 의 소유권을 갖습니다.

void QGridLayout::addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment())

layout 을 그리드의 (row, column) 위치에 배치합니다. 왼쪽 상단 위치는 (0, 0)입니다.

정렬 방식은 alignment 로 지정됩니다. 기본 정렬 값은 0이며, 이는 위젯이 셀 전체를 채운다는 것을 의미합니다.

0이 아닌 정렬 값은 레이아웃이 사용 가능한 공간을 채우기 위해 확장되어서는 안 되며, sizeHint()에 따라 크기가 조정되어야 함을 나타냅니다.

layout 는 그리드 레이아웃의 자식이 됩니다.

void QGridLayout::addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

이 버전에서는 셀 그리드에 여러 행/열에 걸쳐 배치되는 ‘ layout ’ 레이아웃이 추가되었습니다. 해당 셀은 row, column 에서 시작하여 rowSpan 행과 columnSpan 열에 걸쳐 배치됩니다.

rowSpan 및/또는 columnSpan 가 -1인 경우, 레이아웃은 각각 하단 및/또는 오른쪽 가장자리까지 확장됩니다.

void QGridLayout::addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment())

지정된 widget 를 row, column 의 셀 그리드에 추가합니다. 기본적으로 왼쪽 상단 위치는 (0, 0)입니다.

정렬 방식은 alignment 로 지정됩니다. 기본 정렬 값은 0이며, 이는 위젯이 셀 전체를 채운다는 것을 의미합니다.

void QGridLayout::addWidget(QWidget *widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

이 버전은 지정된 widget 를 셀 그리드에 추가하여 여러 행/열에 걸쳐 배치합니다. 셀은 fromRow, fromColumn 에서 시작하여 rowSpan 행과 columnSpan 열에 걸쳐 배치됩니다. widget 에는 지정된 alignment 가 적용됩니다.

rowSpan 및/또는 columnSpan 가 -1인 경우, 위젯은 각각 하단 및/또는 오른쪽 가장자리까지 확장됩니다.

QRect QGridLayout::cellRect(int row, int column) const

그리드에서 행 row 및 열 column 에 위치한 셀의 기하 정보를 반환합니다. row 또는 column 이 그리드 범위를 벗어날 경우 유효하지 않은 사각형을 반환합니다.

int QGridLayout::columnCount() const

이 그리드의 열 수를 반환합니다.

int QGridLayout::columnMinimumWidth(int column) const

column 열의 열 간격을 반환합니다.

setColumnMinimumWidth()도 참조하십시오 .

int QGridLayout::columnStretch(int column) const

column 열의 신축 계수를 반환합니다.

setColumnStretch()도 참조하십시오 .

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

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

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

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

void QGridLayout::getItemPosition(int index, int *row, int *column, int *rowSpan, int *columnSpan) const

지정된 ` index`에 해당하는 항목의 위치 정보를 반환합니다.

row 및 column 로 전달된 변수에는 레이아웃 내 항목의 위치가 반영되며, rowSpan 및 columnSpan 변수에는 항목의 세로 및 가로 길이가 반영됩니다.

itemAtPosition() 및 itemAt()도 참조하십시오 .

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

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

[override virtual] int QGridLayout::heightForWidth(int w) const

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

[override virtual] void QGridLayout::invalidate()

QLayout::invalidate()를 재구현합니다.

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

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

QLayoutItem *QGridLayout::itemAtPosition(int row, int column) const

(row, column) 셀을 차지하는 레이아웃 항목을 반환하며, 셀이 비어 있는 경우에는 nullptr 를 반환합니다.

getItemPosition() 및 indexOf()도 참조하십시오 .

[override virtual] QSize QGridLayout::maximumSize() const

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

[override virtual] int QGridLayout::minimumHeightForWidth(int w) const

QLayoutItem::minimumHeightForWidth(int w) const를 재구현합니다.

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

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

Qt::Corner QGridLayout::originCorner() const

그리드의 원점, 즉 (0, 0) 위치에 해당하는 모서리를 반환합니다.

setOriginCorner()도 참조하십시오 .

int QGridLayout::rowCount() const

이 그리드의 행 수를 반환합니다.

int QGridLayout::rowMinimumHeight(int row) const

row 행에 설정된 최소 너비를 반환합니다.

setRowMinimumHeight()도 참조하십시오 .

int QGridLayout::rowStretch(int row) const

row 행에 대한 신축 계수를 반환합니다.

setRowStretch()도 참조하십시오 .

void QGridLayout::setColumnMinimumWidth(int column, int minSize)

column 열의 최소 너비를 minSize 픽셀로 설정합니다.

columnMinimumWidth() 및 setRowMinimumHeight()도 참조하십시오 .

void QGridLayout::setColumnStretch(int column, int stretch)

column 열의 확장 계수를 stretch 로 설정합니다. 첫 번째 열은 번호 0입니다.

확장 계수는 이 그리드 내의 다른 열을 기준으로 합니다. 확장 계수가 더 높은 열일수록 사용 가능한 공간을 더 많이 차지합니다.

기본 스트레치 계수는 0입니다. 스트레치 계수가 0이고 이 테이블의 다른 열이 전혀 확장될 수 없는 경우에도, 해당 열은 여전히 확장될 수 있습니다.

다른 방법으로는 ` addItem()` 함수를 사용하여 ` QSpacerItem`를 지정해 간격을 추가하는 것입니다.

columnStretch() 및 setRowStretch()도 참조하십시오 .

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

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

void QGridLayout::setOriginCorner(Qt::Corner corner)

그리드의 원점 모서리, 즉 (0, 0) 위치를 corner 로 설정합니다.

originCorner()도 참조하십시오 .

void QGridLayout::setRowMinimumHeight(int row, int minSize)

row 행의 최소 높이를 minSize 픽셀로 설정합니다.

rowMinimumHeight() 및 setColumnMinimumWidth()도 참조하십시오 .

void QGridLayout::setRowStretch(int row, int stretch)

row 행의 신축 계수를 stretch 로 설정합니다. 첫 번째 행은 0번입니다.

확장 계수는 이 그리드 내의 다른 행들에 상대적입니다. 확장 계수가 더 높은 행일수록 사용 가능한 공간을 더 많이 차지합니다.

기본 스트레치 계수는 0입니다. 스트레치 계수가 0이고 이 테이블의 다른 행이 전혀 확장될 수 없는 경우에도, 해당 행은 여전히 확장될 수 있습니다.

rowStretch(), setRowMinimumHeight(), setColumnStretch()도 참조하십시오 .

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

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

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

spacing(), setVerticalSpacing() 및 setHorizontalSpacing()도 참조하십시오 .

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

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

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

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

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

setSpacing(), verticalSpacing(), horizontalSpacing()도 참조하십시오 .

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

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