Back to Qt.io
Contact Us Blog Download Qt

Flow QML Type

자식을 나란히 배치하고 필요에 따라 감싸줍니다. 더 보기...

Import Statement: import QtQuick
Inherits:

Item

속성

신호

방법

상세 설명

플로우 항목은 페이지에서 단어처럼 하위 항목을 배치하여 항목의 행 또는 열을 만들도록 래핑합니다.

아래는 다양한 Text 항목이 포함된 흐름입니다:

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

플로우 항목은 필요에 따라 하위 Text 항목을 나란히 배치하여 자동으로 줄 바꿈합니다:

흐름 내의 항목이 visible 이 아니거나 너비 또는 높이가 0인 경우 해당 항목은 레이아웃되지 않으며 흐름 내에서 표시되지 않습니다. 또한 플로우는 자동으로 하위 항목의 위치를 지정하므로 플로우 내의 하위 항목은 x 또는 y 위치를 설정하거나 anchor 속성을 사용하여 자신을 앵커링해서는 안 됩니다.

플로우 및 기타 관련 포지셔너 유형 사용에 대한 자세한 내용은 항목 포지셔너를 참조하세요.

Column, Row, Grid, Positioner, 및 Qt Quick 예제 - 포지셔너를참조하세요 .

속성 문서

bottomPadding : real

leftPadding : real

padding : real

rightPadding : real

topPadding : real

이 프로퍼티는 콘텐츠 주위의 패딩을 유지합니다.


add : Transition

이 프로퍼티는 이 포지셔너에 추가된 항목에 대해 실행할 전환을 보유합니다. 포지셔너의 경우 다음에 적용됩니다:

  • 포지셔너가 생성된 후 포지셔너의 자식으로 생성되거나 다시 부모로 지정된 항목
  • Item::visible 속성을 false에서 true로 변경하여 이제 표시되는 하위 항목

전환은 ViewTransition 속성을 사용하여 추가되는 항목에 대한 자세한 정보에 액세스할 수 있습니다. 이러한 전환 사용에 대한 자세한 내용과 예제는 ViewTransition 문서를 참조하세요.

참고: 이 전환은 생성 시점에 이미 포지셔너의 일부인 항목에는 적용되지 않습니다. 이 경우 populate 전환이 대신 적용됩니다.

populate, ViewTransition, Qt Quick 예제 - 포지셔너를참조하세요 .


effectiveLayoutDirection : enumeration [read-only]

이 속성은 흐름의 효과적인 레이아웃 방향을 유지합니다.

로캘 레이아웃에 첨부된 속성 LayoutMirroring::enabled 을 사용하면 그리드 포지셔너의 시각적 레이아웃 방향이 미러링됩니다. 그러나 layoutDirection 속성은 변경되지 않습니다.

Flow::layoutDirection 및 LayoutMirroring 을참조하세요 .


flow : enumeration

이 속성은 레이아웃의 흐름을 유지합니다.

가능한 값은 다음과 같습니다:

  • Flow.LeftToRight(기본값) - 항목이 흐름 너비를 초과할 때까지 layoutDirection 에 따라 나란히 배치된 다음 다음 줄로 래핑됩니다.
  • Flow.TopToBottom - 항목이 흐름의 높이를 초과할 때까지 위에서 아래로 나란히 배치된 다음 다음 열로 래핑됩니다.

layoutDirection : enumeration

이 속성은 레이아웃의 레이아웃 방향을 유지합니다.

가능한 값은 다음과 같습니다:

  • Qt.LeftToRight(기본값) - 항목이 위에서 아래로, 왼쪽에서 오른쪽으로 배치됩니다. 흐름 방향은 Flow::flow 속성에 따라 달라집니다.
  • Qt.RightToLeft - 항목이 위에서 아래로, 오른쪽에서 왼쪽으로 배치됩니다. 흐름 방향은 Flow::flow 속성에 따라 달라집니다.

Grid::layoutDirection 및 Row::layoutDirection 을참조하세요 .


move : Transition

이 속성은 포지셔너 내에서 이동한 항목에 대해 실행할 전환을 유지합니다. 포지셔너의 경우 다음에 적용됩니다:

  • 포지셔너에서 다른 항목의 추가, 제거 또는 재배치로 인해 이동하는 자식 항목
  • 포지셔너 내 다른 항목의 크기 조정으로 인해 위치가 변경되는 하위 항목

ViewTransition 속성을 사용하여 이동 중인 항목에 대한 자세한 정보를 확인할 수 있습니다. 그러나 이 이동 전환의 경우 ViewTransition.targetIndexes 및 ViewTransition.targetItems 목록은 포지셔너에 다른 항목이 추가되어 이 전환이 트리거되는 경우에만 설정되며, 그 외의 경우에는 이 목록이 비어 있다는 점에 유의하세요. 이러한 전환 사용에 대한 자세한 내용과 예제는 ViewTransition 문서를 참조하세요.

add, populate, ViewTransition, Qt Quick 예제 - 포지셔너도참조하세요 .


populate : Transition

이 속성은 생성 시 이 포지셔너의 일부인 항목에 대해 실행할 전환을 보유합니다. 트랜지션은 포지셔너가 처음 생성될 때 실행됩니다.

트랜지션은 ViewTransition 속성을 사용하여 추가되는 항목에 대한 자세한 정보에 액세스할 수 있습니다. 이러한 전환 사용에 대한 자세한 내용과 예제는 ViewTransition 문서를 참조하세요.

add, ViewTransition, Qt Quick 예제 - 포지셔너도참조하세요 .


spacing : real

간격은 인접한 각 항목 사이에 비워 두는 픽셀 단위의 양이며 기본값은 0입니다.

Grid::spacing도 참조하세요 .


신호 문서

positioningComplete()

포지셔닝이 완료되면 이 신호가 발생합니다.

참고: 해당 핸들러는 onPositioningComplete 입니다.


메서드 문서

forceLayout()

플로우는 일반적으로 프레임당 한 번씩 자식들을 포지셔닝합니다. 즉, 스크립트 블록 내부에서 하위 자식은 변경되었지만 플로우는 아직 그에 따라 업데이트되지 않았을 수 있습니다.

이 메서드는 흐름이 자식의 미결 변경 사항에 즉시 응답하도록 합니다.

참고: 일반적으로 메서드는 컴포넌트가 완료된 후에만 호출해야 합니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.