Flow QML Type

자식 노드를 나란히 배치하며, 필요한 경우 줄바꿈을 적용합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• flow : enumeration
• layoutDirection : enumeration
• leftPadding : real
• move : Transition
• padding : real
• populate : Transition
• rightPadding : real
• spacing : real
• topPadding : real

신호

• positioningComplete()

방법

• void forceLayout()

상세 설명

'Flow' 항목은 자식 항목들을 마치 페이지 위의 단어처럼 배치하며, 줄바꿈을 통해 항목들을 행이나 열로 구성합니다.

다음은 다양한 ' Text ' 항목을 포함하는 Flow 예시입니다:

    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 }
    }

'Flow' 항목은 자식 ' Text ' 항목들을 필요에 따라 줄바꿈하며 자동으로 나란히 배치합니다:

Flow 내의 항목이 ` visible`가 아니거나 너비나 높이가 0인 경우, 해당 항목은 레이아웃이 적용되지 않으며 Flow 내에서 표시되지 않습니다. 또한 Flow는 자식 항목의 위치를 자동으로 조정하므로, Flow 내의 자식 항목은 ` x ` 또는 ` y ` 위치를 설정하거나 ` anchor ` 속성을 사용하여 자체적으로 고정해서는 안 됩니다.

Flow 및 기타 관련 위치 지정자 유형의 사용에 대한 자세한 내용은 ‘항목 위치 지정자(Item Positioners)’를 참조하십시오.

또한 Column, Row, Grid, Positioner 및 Qt Quick 예제 - 위치 지정기를참조하십시오 .

속성 설명서

add : Transition

이 속성은 이 포지셔너에 추가되는 항목에 대해 실행될 전환 효과를 지정합니다. 포지셔너의 경우, 이 속성은 다음 항목에 적용됩니다:

• 포지셔너가 생성된 후, 포지셔너의 자식으로 생성되거나 부모가 변경된 아이템
• Item::visible 속성이 false에서 true로 변경되어 이제 표시되는 자식 항목

이 전환 효과는 ` ViewTransition ` 속성을 사용하여 추가되는 항목에 대한 자세한 정보를 얻을 수 있습니다. 이러한 전환 효과 사용에 대한 자세한 내용과 예제는 ` ViewTransition ` 문서를 참조하십시오.

populate, ViewTransition 및 Qt Quick 예제 - 포지셔너도참조하십시오 .

이 속성들은 콘텐츠 주변의 패딩을 지정합니다.

effectiveLayoutDirection : enumeration [read-only]

이 속성은 플로우의 실제 레이아웃 방향을 지정합니다.

로케일 레이아웃에 대해 첨부 속성 LayoutMirroring::enabled 을 사용할 경우, 그리드 포지셔너의 시각적 레이아웃 방향이 반전됩니다. 그러나 속성 layoutDirection 은 변경되지 않습니다.

Flow::layoutDirection 및 LayoutMirroring도 참조하십시오 .

flow : enumeration

이 속성은 레이아웃의 흐름을 결정합니다.

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

• Flow.LeftToRight (기본값) - 항목들은 ‘ layoutDirection ’에 따라 서로 나란히 배치되며, Flow의 너비를 초과하면 다음 줄로 넘어갑니다.
• 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도 참조하십시오 .

Signal 문서

positioningComplete()

이 신호는 위치 지정이 완료되었을 때 발생합니다.

메서드 문서

void forceLayout()

Flow는 일반적으로 프레임당 한 번씩 자식 요소를 배치합니다. 즉, 스크립트 블록 내부에서는 기본 자식 요소가 변경되었을 수 있지만, Flow는 아직 그에 따라 업데이트되지 않았을 수 있습니다.

이 메서드는 Flow가 자식 요소의 미처리된 변경 사항에 즉시 반응하도록 강제합니다.

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