QGraphicsLayout Class

멤버 함수 문서

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

QGraphicsLayout 객체를 생성합니다.

parent 는 QGraphicsLayoutItem 의 생성자에 전달되고 QGraphicsLayoutItem 의 isLayout 인수는 true로 설정됩니다.

parent 가 QGraphicsWidget 인 경우 해당 위젯에 레이아웃이 설치됩니다. (레이아웃을 설치하면 설치된 이전 레이아웃이 삭제됩니다.) 참고하세요.

[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()

QGraphicsLayout 객체를 삭제합니다.

void QGraphicsLayout::activate()

레이아웃을 활성화하여 레이아웃의 모든 항목이 즉시 재정렬되도록 합니다. 이 함수는 count() 및 itemAt()을 호출한 다음 모든 항목에서 순차적으로 setGeometry()을 호출하는 것을 기반으로 합니다. 활성화되면 레이아웃이 상위의 contentsRect()에 맞게 지오메트리를 조정합니다. 그러면 부모는 자체 레이아웃을 무효화합니다.

크기가 조정되는 것에 대한 응답으로 정렬된 항목 중 하나에 의해 순차적으로 또는 재귀적으로 호출되는 경우 이 함수는 아무 작업도 수행하지 않습니다.

레이아웃은 이 프로세스를 최적화하기 위해 지오메트리 캐싱을 자유롭게 사용할 수 있습니다. 이러한 캐시를 강제로 무효화하려면 activate()를 호출하기 전에 invalidate()를 호출하면 됩니다.

invalidate()도 참조하세요 .

[protected] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)

이 기능은 사용자 정의 레이아웃을 위해 제공되는 편의 기능으로, 레이아웃의 모든 항목을 살펴보고 레이아웃의 가장 가까운 QGraphicsWidget 조상으로 그래픽 항목을 다시 부모로 지정합니다.

layoutItem 이 이미 다른 레이아웃에 있는 경우 해당 레이아웃에서 제거됩니다.

사용자 정의 레이아웃에서 특별한 동작을 원하는 경우 이 함수를 무시하고 자체 동작을 구현할 수 있습니다.

graphicsItem()도 참조하세요 .

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

이 순수 가상 함수는 레이아웃의 항목 수를 반환하려면 QGraphicsLayout 의 하위 클래스에서 다시 구현해야 합니다.

서브클래스는 항목을 저장하는 방법을 자유롭게 결정할 수 있습니다.

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

[override virtual] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

재구현합니다: QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const.

[virtual] void QGraphicsLayout::invalidate()

레이아웃에서 캐시된 지오메트리 및 크기 힌트 정보를 모두 지우고 관리되는 부모 QGraphicsLayoutItem 에 LayoutRequest 이벤트를 게시합니다.

activate() 및 setGeometry()도 참조하세요 .

bool QGraphicsLayout::isActivated() const

레이아웃이 현재 활성화 중이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 레이아웃이 활성화 중이면 현재 항목을 재정렬하는 중임을 의미합니다(즉, activate() 함수가 호출되었지만 아직 반환되지 않았음).

activate() 및 invalidate()도 참조하세요 .

[pure virtual] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const

이 순수 가상 함수는 QGraphicsLayout 의 서브클래스에서 다시 구현해야 인덱스 i 에 있는 항목에 대한 포인터를 반환할 수 있습니다. 재구현은 i 가 유효하다고 가정할 수 있습니다(즉, count() 값을 존중합니다). count ()와 함께 레이아웃의 모든 항목을 반복하는 수단으로 제공됩니다.

서브클래스는 항목을 저장하는 방법을 자유롭게 결정할 수 있으며, 시각적 배열은 이 함수를 통해 반영할 필요가 없습니다.

count() 및 removeAt()도 참조하세요 .

[pure virtual] void QGraphicsLayout::removeAt(int index)

이 순수 가상 함수는 index 에서 항목을 제거하려면 QGraphicsLayout 의 서브클래스에서 다시 구현해야 합니다. 재구현은 index 가 유효하다고 가정할 수 있습니다(즉, count() 값을 존중합니다).

제거된 항목은 레이아웃 계층 구조에서 제거된 것으로 간주되므로 구현에서는 제거된 항목의 parentLayoutItem()가 이 레이아웃을 가리키지 않도록 해야 합니다.

레이아웃을 애플리케이션 간에 재사용하려는 경우 레이아웃에서 항목을 삭제하는 것이 좋지만 그래픽 보기 프레임워크는 이에 의존하지 않습니다.

서브클래스는 항목을 저장하는 방법을 자유롭게 결정할 수 있습니다.

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

void QGraphicsLayout::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

콘텐츠 여백을 left, top, right, bottom 으로 설정합니다. 최상위 레이아웃의 기본 콘텐츠 여백은 스타일에 따라 달라집니다( QStyle::PM_LayoutLeftMargin, QStyle::PM_LayoutTopMargin, QStyle::PM_LayoutRightMargin 및 QStyle::PM_LayoutBottomMargin 에 대해 pixelMetric을 쿼리하여).

서브 레이아웃의 경우 기본 여백은 0입니다.

콘텐츠 여백을 변경하면 레이아웃이 자동으로 무효화됩니다.

invalidate()도 참조하세요 .

[override virtual] void QGraphicsLayout::updateGeometry()

다시 구현합니다: QGraphicsLayoutItem::updateGeometry().

[virtual] void QGraphicsLayout::widgetEvent(QEvent *e)

QGraphicsLayout 는 이 이벤트 핸들러를 사용하여 지오메트리 변경, 레이아웃 변경 또는 레이아웃 방향 변경과 같은 레이아웃 관련 이벤트를 수신합니다.

e 는 이벤트에 대한 포인터입니다.

이 이벤트 핸들러를 다시 구현하여 사용자 정의 레이아웃에 대한 유사한 이벤트를 추적할 수 있습니다.

QGraphicsWidget::event() 및 QGraphicsItem::sceneEvent()도 참조하세요 .