Row QML Type

자식 노드를 일렬로 배치합니다. 더 보기...

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

속성

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

신호

• positioningComplete()

방법

• void forceLayout()

상세 설명

Row는 자식 항목을 단일 행에 배치하는 유형입니다. 앵커를 사용하지 않고 일련의 항목을 수평으로 배치하는 편리한 방법으로 사용할 수 있습니다.

다음은 크기가 각기 다른 세 개의 사각형을 포함하는 Row입니다:

import QtQuick

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

Row는 이러한 항목들을 다음과 같이 자동으로 수평으로 배열합니다:

Row 내의 항목이 ` visible`가 아니거나 너비나 높이가 0인 경우, 해당 항목은 레이아웃에 포함되지 않으며 Row 내에서 표시되지 않습니다. 또한 Row는 자식 항목을 자동으로 수평으로 배치하므로, Row 내의 자식 항목은 ` x ` 위치를 설정하거나 ` left`, ` right`, ` anchors.horizontalCenter`, ` fill `, ` centerIn ` 앵커를 사용하여 수평으로 고정해서는 안 됩니다. 이러한 작업을 수행해야 하는 경우, Row를 사용하지 않고 항목의 위치를 직접 지정하는 방법을 고려해 보십시오.

Row 내의 항목은 Positioner 첨부 속성을 사용하여 Row 내에서의 위치에 대한 추가 정보에 접근할 수 있습니다.

Row 및 기타 관련 위치 지정기 유형의 사용에 대한 자세한 내용은 항목 위치 지정기를 참조하십시오.

또한 Column, Grid, Flow, Positioner, RowLayout 및 Qt Quick 예제 - 포지셔너를참조하십시오 .

속성 설명서

add : Transition

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

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

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

관련 항목: populate, ViewTransition, Qt Quick 예제 - 포지셔너.

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

effectiveLayoutDirection : enumeration [read-only]

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

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

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

layoutDirection : enumeration

이 속성은 행의 layoutDirection을 나타냅니다.

사용 가능한 값:

Grid::layoutDirection 및 Flow::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()

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

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

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