QLayout Class

멤버 함수 문서

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

parent 를 부모로 하는 새로운 최상위 QLayout을 생성합니다.

이 레이아웃은 parent 의 최상위 레이아웃으로 직접 설정됩니다. 위젯당 최상위 레이아웃은 하나만 존재할 수 있습니다. 이 레이아웃은 QWidget::layout() 함수를 통해 반환됩니다.

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

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

bool QLayout::activate()

필요한 경우 parentWidget()의 레이아웃을 다시 처리합니다.

이 함수는 가장 적절한 시점에 자동으로 호출되므로 일반적으로 직접 호출할 필요는 없습니다. 레이아웃이 다시 수행된 경우 true를 반환합니다.

update() 및 QWidget::updateGeometry()도 참조하십시오 .

[protected] void QLayout::addChildLayout(QLayout *childLayout)

이 함수는 하위 클래스의 ` addLayout() ` 또는 ` insertLayout() ` 함수에서 호출되어 레이아웃 ` childLayout `을 하위 레이아웃으로 추가합니다.

이 함수를 직접 호출해야 하는 유일한 경우는 중첩된 레이아웃을 지원하는 사용자 정의 레이아웃을 구현하는 경우입니다.

QBoxLayout::addLayout(), QBoxLayout::insertLayout() 및 QGridLayout::addLayout()도 참조하십시오 .

[protected] void QLayout::addChildWidget(QWidget *w)

이 함수는 하위 클래스의 ` addWidget() ` 함수에서 호출되어 ` w `를 레이아웃의 관리 대상 위젯으로 추가합니다.

w 가 이미 레이아웃에 의해 관리되고 있는 경우, 이 함수는 경고 메시지를 출력하고 해당 레이아웃에서 w 를 제거합니다. 따라서 이 함수는 w 를 레이아웃의 데이터 구조에 추가하기 전에 호출되어야 합니다.

[pure virtual] void QLayout::addItem(QLayoutItem *item)

item 를 추가하기 위해 하위 클래스에서 구현됩니다. 추가 방식은 각 하위 클래스마다 다릅니다.

이 함수는 일반적으로 애플리케이션 코드에서 호출되지 않습니다. 레이아웃에 위젯을 추가하려면 addWidget() 함수를 사용하고, 자식 레이아웃을 추가하려면 관련 QLayout 하위 클래스에서 제공하는 addLayout() 함수를 사용하십시오.

참고: item 의 소유권은 레이아웃으로 이전되며, 이를 삭제하는 것은 레이아웃의 책임입니다.

참조: addWidget(), QBoxLayout::addLayout(), QGridLayout::addLayout().

void QLayout::addWidget(QWidget *w)

이 레이아웃에 w 위젯을 레이아웃에 맞는 방식으로 추가합니다. 이 함수는 addItem()를 사용합니다.

[protected] QRect QLayout::alignmentRect(const QRect &r) const

이 레이아웃이 setAlignment()을 지원하는 경우, 이 레이아웃의 지오메트리가 r 로 설정되었을 때 가려져야 할 직사각형을 반환합니다.

결과는 ` sizeHint()` 및 ` expandingDirections()` 함수에서 파생됩니다. 이 직사각형의 크기는 ` r`보다 크지 않습니다.

[override virtual protected] void QLayout::childEvent(QChildEvent *e)

QObject::childEvent(QChildEvent *event)를 재구현합니다.

[static] QSize QLayout::closestAcceptableSize(const QWidget *widget, const QSize &size)

widget 의 모든 크기 제약 조건( heightForWidth() 포함)을 충족하면서, size 에 최대한 가까운 크기를 반환합니다.

QMargins QLayout::contentsMargins() const

레이아웃 주변에 적용된 여백을 반환합니다.

기본적으로 ` QLayout `는 스타일에서 제공된 값을 사용합니다. 대부분의 플랫폼에서 여백은 모든 방향으로 11픽셀입니다.

setContentsMargins()도 참조하십시오 .

QRect QLayout::contentsRect() const

레이아웃의 ` geometry()` 사각형을 반환하되, 콘텐츠의 여백을 고려합니다.

setContentsMargins() 및 getContentsMargins()도 참조하십시오 .

[override virtual] QSizePolicy::ControlTypes QLayout::controlTypes() const

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

[pure virtual] int QLayout::count() const

레이아웃에 포함된 항목의 개수를 반환하려면 하위 클래스에서 이 메서드를 구현해야 합니다.

itemAt()도 참조하십시오 .

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

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

이 레이아웃이 sizeHint()보다 더 많은 공간을 사용할 수 있는지 여부를 반환합니다. Qt::Vertical 또는 Qt::Horizontal 값은 한 차원만 확장하고자 함을 의미하는 반면, Qt::Vertical | Qt::Horizontal 값은 두 차원 모두에서 확장하고자 함을 의미합니다.

기본 구현체는 Qt::Horizontal | Qt::Vertical 를 반환합니다. 하위 클래스는 자식 위젯의 size policies 에 따라 의미 있는 값을 반환하도록 이를 재구현합니다.

sizeHint()도 참조하십시오 .

[override virtual] QRect QLayout::geometry() const

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

setGeometry()도 참조하십시오 .

void QLayout::getContentsMargins(int *left, int *top, int *right, int *bottom) const

left, top, right 및 bottom 중 nullptr 가 아닌 각 도메인에 대해, 포인터가 가리키는 위치에 명시된 여백의 크기를 저장합니다.

기본적으로 QLayout 는 스타일에서 제공된 값을 사용합니다. 대부분의 플랫폼에서 여백은 모든 방향으로 11픽셀입니다.

setContentsMargins(), QStyle::pixelMetric(), PM_LayoutLeftMargin, PM_LayoutTopMargin, PM_LayoutRightMargin 및 PM_LayoutBottomMargin도 참조하십시오 .

[virtual] int QLayout::indexOf(const QLayoutItem *layoutItem) const

이 레이아웃(자식 레이아웃 제외)에서 레이아웃 항목 layoutItem 을 검색합니다.

layoutItem 의 인덱스를 반환하며, layoutItem 을 찾을 수 없는 경우 -1을 반환합니다.

[virtual] int QLayout::indexOf(const QWidget *widget) const

이 레이아웃(자식 레이아웃 제외)에서 ‘ widget ’ 위젯을 검색합니다.

widget 의 인덱스를 반환하며, widget 를 찾을 수 없는 경우 -1을 반환합니다.

기본 구현은 itemAt()를 사용하여 모든 항목을 순회합니다.

[override virtual] void QLayout::invalidate()

QLayoutItem::invalidate()을 재구현합니다.

[override virtual] bool QLayout::isEmpty() const

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

bool QLayout::isEnabled() const

레이아웃이 활성화되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setEnabled()도 참조하십시오 .

[pure virtual] QLayoutItem *QLayout::itemAt(int index) const

index 에 있는 레이아웃 항목을 반환하려면 하위 클래스에서 이 함수를 구현해야 합니다. 해당 항목이 없는 경우, 이 함수는 nullptr 를 반환해야 합니다. 항목 번호는 0부터 연속적으로 매겨집니다. 항목이 삭제되면 다른 항목의 번호가 재조정됩니다.

이 함수는 레이아웃을 순회하는 데 사용할 수 있습니다. 다음 코드는 위젯의 레이아웃 구조에 있는 각 레이아웃 항목에 대해 사각형을 그립니다.

static void paintLayout(QPainter *painter, QLayoutItem *item)
{
    QLayout *layout = item->layout();
    if (layout) {
        for (int i = 0; i < layout->count(); ++i)
            paintLayout(painter, layout->itemAt(i));
    }
    painter->drawRect(item->geometry());
}

void MyWidget::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    if (layout())
        paintLayout(&painter, layout());
}

count() 및 takeAt()도 참조하십시오 .

[override virtual] QLayout *QLayout::layout()

QLayoutItem::layout()을 재구현합니다.

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

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

이 레이아웃의 최대 크기를 반환합니다. 이는 사양을 준수하는 범위 내에서 레이아웃이 가질 수 있는 최대 크기입니다.

반환된 값에는 QWidget::setContentsMargins() 또는 menuBar()에 필요한 공간은 포함되지 않습니다.

기본 구현에서는 크기 조정이 무제한으로 허용됩니다.

QWidget *QLayout::menuBar() const

이 레이아웃에 설정된 메뉴 바를 반환하거나, 메뉴 바가 설정되어 있지 않은 경우 ` nullptr `를 반환합니다.

setMenuBar()도 참조하십시오 .

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

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

이 레이아웃의 최소 크기를 반환합니다. 이는 사양을 준수하면서 레이아웃이 가질 수 있는 가장 작은 크기입니다.

반환된 값에는 QWidget::setContentsMargins() 또는 menuBar()에 필요한 공간은 포함되지 않습니다.

기본 구현에서는 크기 조정이 무제한으로 허용됩니다.

QWidget *QLayout::parentWidget() const

이 레이아웃의 상위 위젯을 반환하며, 이 레이아웃이 어떤 위젯에도 설치되어 있지 않은 경우에는 ` nullptr `를 반환합니다.

레이아웃이 하위 레이아웃인 경우, 이 함수는 상위 레이아웃의 부모 위젯을 반환합니다.

parent()도 참조하십시오 .

void QLayout::removeItem(QLayoutItem *item)

레이아웃에서 item 레이아웃 항목을 제거합니다. 해당 항목을 삭제하는 것은 호출자의 책임입니다.

item 는 레이아웃일 수 있습니다( QLayout 가 QLayoutItem 를 상속받기 때문입니다).

removeWidget() 및 addItem()도 참조하십시오 .

void QLayout::removeWidget(QWidget *widget)

레이아웃에서 widget 위젯을 제거합니다. 이 호출 이후, 위젯에 적절한 지오메트리를 지정하거나, 위젯을 다시 레이아웃에 배치하거나, 필요한 경우 명시적으로 숨기는 것은 호출자의 책임입니다.

참고: widget 의 소유권은 추가되었을 때와 동일하게 유지됩니다.

removeItem(), QWidget::setGeometry(), addWidget()도 참조하십시오 .

[virtual] QLayoutItem *QLayout::replaceWidget(QWidget *from, QWidget *to, Qt::FindChildOptions options = Qt::FindChildrenRecursively)

위젯 from 을 검색하고, 발견되면 위젯 to 으로 대체합니다. 성공 시 위젯 from 을 포함하는 레이아웃 항목을 반환합니다. 그렇지 않은 경우 nullptr 이 반환됩니다. options 에 Qt::FindChildrenRecursively (기본값)이 포함되어 있는 경우, 대체 작업을 수행하기 위해 하위 레이아웃을 검색합니다. options 에 포함된 다른 플래그는 무시됩니다.

따라서 반환된 항목은 이 레이아웃에 속하지 않고 하위 레이아웃에 속할 수도 있다는 점에 유의하십시오.

반환된 레이아웃 항목은 더 이상 해당 레이아웃이 소유하지 않으므로, 삭제하거나 다른 레이아웃에 삽입해야 합니다. 위젯 from 은 더 이상 레이아웃에 의해 관리되지 않으므로, 삭제하거나 숨겨야 할 수 있습니다. 위젯 from 의 부모는 변경되지 않은 상태로 유지됩니다.

이 함수는 내장된 Qt 레이아웃에서는 작동하지만, 사용자 정의 레이아웃에서는 작동하지 않을 수 있습니다.

indexOf()도 참조하십시오 .

bool QLayout::setAlignment(QWidget *w, Qt::Alignment alignment)

위젯 w 의 정렬을 alignment 로 설정하고, 이 레이아웃(자식 레이아웃 제외)에서 w 가 발견되면 true를 반환하며, 그렇지 않으면 false 를 반환합니다.

bool QLayout::setAlignment(QLayout *l, Qt::Alignment alignment)

l 레이아웃의 정렬을 alignment 으로 설정하고, 이 레이아웃(자식 레이아웃 제외)에서 l 가 발견되면 true 를 반환하며, 그렇지 않으면 false 를 반환합니다.

void QLayout::setContentsMargins(const QMargins &margins)

레이아웃 주위에 적용할 ‘ margins ’을 설정합니다.

기본적으로 ` QLayout `는 스타일에 지정된 값을 사용합니다. 대부분의 플랫폼에서 여백은 모든 방향으로 11픽셀입니다.

contentsMargins()도 참조하십시오 .

void QLayout::setContentsMargins(int left, int top, int right, int bottom)

left, top, right 및 bottom 의 여백을 레이아웃 주위에 적용하도록 설정합니다.

기본적으로 ` QLayout `는 스타일에서 지정된 값을 사용합니다. 대부분의 플랫폼에서 여백은 모든 방향으로 11픽셀입니다.

참조: getContentsMargins(), QStyle::pixelMetric(), PM_LayoutLeftMargin, PM_LayoutTopMargin, PM_LayoutRightMargin, PM_LayoutBottomMargin.

void QLayout::setEnabled(bool enable)

enable 가 true인 경우 이 레이아웃을 활성화하고, 그렇지 않은 경우 비활성화합니다.

활성화된 레이아웃은 변경 사항에 따라 동적으로 조정되며, 비활성화된 레이아웃은 마치 존재하지 않는 것처럼 동작합니다.

기본적으로 모든 레이아웃은 활성화되어 있습니다.

isEnabled()도 참조하십시오 .

[override virtual] void QLayout::setGeometry(const QRect &r)

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

geometry()도 참조하십시오 .

void QLayout::setMenuBar(QWidget *widget)

지오메트리 관리자에게 메뉴 바 widget 를 parentWidget()의 상단, QWidget::contentsMargins() 바깥쪽에 배치하도록 지시합니다. 모든 자식 위젯은 메뉴 바의 하단 가장자리 아래에 배치됩니다.

menuBar()도 참조하십시오 .

[since 6.10] void QLayout::setSizeConstraints(QLayout::SizeConstraint horizontal, QLayout::SizeConstraint vertical)

horizontal 와 vertical 의 크기 제약 조건을 모두 설정합니다.

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

sizeConstraint(), horizontalSizeConstraint(), verticalSizeConstraint()도 참조하십시오 .

[pure virtual] QLayoutItem *QLayout::takeAt(int index)

index 에 있는 레이아웃 항목을 레이아웃에서 제거하고 해당 항목을 반환하려면 하위 클래스에서 이 메서드를 구현해야 합니다. 해당 항목이 없는 경우, 이 함수는 아무 작업도 수행하지 않고 0을 반환해야 합니다. 항목 번호는 0부터 연속적으로 매겨집니다. 항목이 제거되면 다른 항목들의 번호가 재조정됩니다.

다음 코드 조각은 레이아웃에서 모든 항목을 안전하게 제거하는 방법을 보여줍니다:

QLayoutItem *child;
while ((child = layout->takeAt(0)) != nullptr) {
    ...
    delete child->widget(); // delete the widget
    delete child;   // delete the layout item
}

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

[since 6.1] void QLayout::unsetContentsMargins()

레이아웃 주변의 사용자 정의 여백을 모두 해제합니다. 레이아웃은 스타일에 지정된 기본값을 사용하게 됩니다.

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

setContentsMargins()도 참조하십시오 .

void QLayout::update()

parentWidget()의 레이아웃을 업데이트합니다.

이 함수는 가장 적절한 시점에 자동으로 호출되므로, 일반적으로 직접 호출할 필요는 없습니다.

activate() 및 invalidate()도 참조하십시오 .