ListView QML Type

currentIndex 속성은 현재 항목의 인덱스를, currentItem 속성은 현재 항목의 인덱스를 보유합니다. currentIndex 을 -1로 설정하면 강조 표시가 지워지고 currentItem 이 null로 설정됩니다.

highlightFollowsCurrentItem 이 true 인 경우 이러한 속성 중 하나를 설정하면 ListView 이 부드럽게 스크롤되어 현재 항목이 표시됩니다.

현재 항목의 위치는 뷰에 표시될 때까지 대략적인 위치만 표시될 수 있습니다.

이러한 속성은 뷰 내에서 (현재 항목에 대한) 하이라이트의 기본 설정 범위를 정의합니다. preferredHighlightBegin 값은 preferredHighlightEnd 값보다 작아야 합니다.

이러한 속성은 목록이 스크롤될 때 현재 항목의 위치에 영향을 줍니다. 예를 들어 뷰를 스크롤할 때 현재 선택된 항목이 목록의 가운데에 있어야 하는 경우 preferredHighlightBegin 및 preferredHighlightEnd 값을 가운데 항목의 위쪽 및 아래쪽 좌표로 설정합니다. currentItem 을 프로그래밍 방식으로 변경하면 현재 항목이 뷰의 가운데에 오도록 목록이 자동으로 스크롤됩니다. 또한 하이라이트가 있는지 여부에 관계없이 현재 항목 인덱스의 동작이 수행됩니다.

highlightRangeMode 의 유효한 값은 다음과 같습니다:

이 속성을 사용하면 뷰 지오메트리 외부에 델리게이트를 표시할 수 있습니다.

이 값이 0이 아닌 경우 뷰는 뷰 시작 전 또는 종료 후에 추가 델리게이트를 만듭니다. 뷰는 지정된 픽셀 크기에 맞을 수 있는 만큼의 델리게이트를 만듭니다.

예를 들어 세로 뷰에서 델리게이트의 높이가 20픽셀이고 displayMarginBeginning 및 displayMarginEnd 이 모두 40으로 설정된 경우 위쪽에 2개의 델리게이트가 생성되고 아래에 2개의 델리게이트가 표시됩니다.

기본값은 0입니다.

이 속성은 특정 UI 구성을 허용하기 위한 것이지 성능 최적화를 위한 것이 아닙니다. 성능상의 이유로 뷰 지오메트리 외부에 델리게이트를 만들려는 경우 cacheBuffer 속성을 대신 사용하는 것이 좋습니다.

이 QML 속성은 QtQuick 2.3에 도입되었습니다.

이러한 프로퍼티는 하이라이트 델리게이트의 이동 속도와 애니메이션 크기 조절을 제어합니다.

highlightFollowsCurrentItem 가 참이어야 이러한 프로퍼티가 적용됩니다.

속도 속성의 기본값은 초당 400픽셀입니다. 지속 시간 속성의 기본값은 -1이며, 즉 하이라이트가 설정된 속도로 이동하는 데 필요한 만큼의 시간이 걸립니다.

SmoothedAnimation이러한 속성은 속도와 지속 시간이 모두 설정된 경우 애니메이션은 더 짧은 지속 시간을 제공하는 속성을 사용합니다.

이동 속도 및 지속 시간 속성은 예를 들어 incrementCurrentIndex()가 호출될 때와 같이 인덱스 변경으로 인한 움직임을 제어하는 데 사용됩니다. 사용자가 ListView 을 플릭하면 플릭의 속도가 대신 이동을 제어하는 데 사용됩니다.

하나의 속성만 설정하려면 다른 속성을 -1 로 설정하면 됩니다. 예를 들어 속도가 아닌 지속 시간만 애니메이션하려면 다음 코드를 사용합니다:

highlightMoveDuration: 1000
highlightMoveVelocity: -1

highlightFollowsCurrentItem 를참조하세요 .

이 속성은 뷰에 추가된 항목에 적용할 전환을 보유합니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    add: Transition {
        NumberAnimation { properties: "x,y"; from: 100; duration: 1000 }
    }
}

위 뷰에 항목이 추가될 때마다 항목은 위치(100,100)에서 뷰 내의 최종 x,y 위치까지 1초에 걸쳐 애니메이션이 적용됩니다. 이 전환은 뷰에 추가된 새 항목에만 적용되며 새 항목의 추가에 따라 이동되는 아래 항목에는 적용되지 않습니다. 이동된 항목에 애니메이션을 적용하려면 displaced 또는 addDisplaced 속성을 설정합니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

addDisplaced, populate, ViewTransition 를참조하세요 .

이 속성은 뷰에 다른 항목이 추가되어 위치가 변경되는 뷰 내의 항목에 적용할 전환을 보유합니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    addDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

위 뷰에 항목이 추가될 때마다 새 항목 아래의 모든 항목이 이동되어 뷰 내에서 아래쪽(가로 방향인 경우 옆으로)으로 이동합니다. 이 이동이 발생하면 지정된 대로 뷰 내에서 항목이 새 x,y 위치로 이동하면 1초 동안 NumberAnimation 애니메이션이 적용됩니다. 이 전환은 뷰에 추가된 새 항목에는 적용되지 않으며, 추가된 항목에 애니메이션을 적용하려면 add 속성을 설정합니다.

항목이 동시에 여러 유형의 작업에 의해 이동되는 경우 addDisplaced, moveDisplaced 또는 removeDisplaced 전환이 적용될지 여부는 정의되지 않습니다. 또한 항목이 추가, 이동 또는 제거 작업에 의해 대체되는지 여부에 따라 다른 전환을 지정할 필요가 없는 경우 displaced 속성을 대신 설정하는 것이 좋습니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

displaced, add, populate 및 ViewTransition 을참조하십시오 .

이 속성은 뷰의 표시 영역 외부에 델리게이트가 유지되는지 여부를 결정합니다.

이 값이 0보다 크면 뷰는 지정된 버퍼에 들어갈 수 있는 만큼의 델리게이트를 인스턴스화할 수 있습니다. 예를 들어 세로 뷰에서 델리게이트의 높이가 20픽셀이고 cacheBuffer 가 40으로 설정된 경우, 보이는 영역 위에 최대 2개의 델리게이트와 아래에 2개의 델리게이트가 생성/유지될 수 있습니다. 버퍼링된 델리게이트는 비동기적으로 생성되므로 여러 프레임에 걸쳐 생성할 수 있고 프레임을 건너뛸 가능성이 줄어듭니다. 페인팅 성능을 향상시키기 위해 보이는 영역 외부의 델리게이트는 페인팅되지 않습니다.

이 프로퍼티의 기본값은 플랫폼에 따라 다르지만 일반적으로 0보다 큰 값이 됩니다. 음수 값은 무시됩니다.

캐시버퍼는 픽셀 버퍼가 아니라 추가로 인스턴스화된 델리게이트만 유지합니다.

cacheBuffer는 displayMarginBeginning 또는 displayMarginEnd 에서 지정한 표시 여백 외부에서 작동합니다.

이 속성은 델리게이트 컴포넌트의 Item 로 표시되거나 인스턴스화되는지 여부에 관계없이 ListView 의 모델에 있는 항목 수를 반영합니다.

이 속성은 현재 뷰의 시작 부분에 있는 섹션을 보유합니다.

델리게이트는 뷰에 의해 인스턴스화된 각 항목을 정의하는 템플릿을 제공합니다. 인덱스는 액세스 가능한 index 속성으로 노출됩니다. 데이터 모델 유형에 따라 모델의 속성도 사용할 수 있습니다.

델리게이트의 개체 및 바인딩 수는 뷰의 플릭 성능에 직접적인 영향을 미칩니다. 가능하면 델리게이트의 일반적인 표시에는 필요하지 않은 기능은 필요할 때 추가 구성 요소를 로드할 수 있는 Loader 에 배치하세요.

ListView 은 델리게이트의 루트 항목의 크기에 따라 항목을 배치합니다.

항목의 하위 픽셀 정렬을 피하려면 델리게이트의 크기를 정수로 설정하는 것이 좋습니다.

델리게이트 인스턴스의 기본값 stacking order 은 1 입니다.

Stacking Order in ListView도 참조하세요 .

이 속성은 뷰에 영향을 미치는 모델 연산에 의해 대체된 항목에 적용할 일반 전환을 보유합니다.

이는 개별 addDisplaced, moveDisplaced 및 removeDisplaced 속성을 지정하지 않고도 추가, 이동 또는 제거 작업에 의해 대체된 모든 항목에 적용할 일반 전환을 지정할 수 있는 편리한 기능입니다. 예를 들어 다음은 이동된 전환을 지정하는 보기입니다:

ListView {
    ...
    displaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

위 뷰 내에서 항목이 추가, 이동 또는 제거되면 그 아래의 항목이 이동되어 뷰 내에서 아래로(가로 방향인 경우 옆으로) 이동하게 됩니다. 이 이동이 발생하면 지정된 대로 뷰 내에서 항목이 새 x,y 위치로 이동하면 1초 동안 NumberAnimation 애니메이션이 적용됩니다.

뷰에서 이 일반 이동 전환과 특정 addDisplaced, moveDisplaced 또는 removeDisplaced 전환을 지정하는 경우 관련 작업이 발생할 때 더 구체적인 전환이 비활성화되지 않았다면( enabled 을 false로 설정하여) 일반 이동 전환 대신 더 구체적인 전환이 사용됩니다. 실제로 비활성화되어 있으면 일반 디스플레이스드 전환이 대신 적용됩니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예제는 ViewTransition 문서를 참조하세요.

addDisplaced, moveDisplaced, removeDisplaced, ViewTransition도 참조 하세요.

이 속성은 가로 방향 목록의 효과적인 레이아웃 방향을 유지합니다.

로캘 레이아웃에 LayoutMirroring::enabled 속성을 사용하는 경우 가로 목록의 시각적 레이아웃 방향이 미러링됩니다. 그러나 layoutDirection 속성은 변경되지 않습니다.

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

이 속성은 바닥글로 사용할 컴포넌트를 보유합니다.

각 뷰에 대해 바닥글 컴포넌트의 인스턴스가 생성됩니다. 바닥글은 모든 항목 다음에 뷰의 끝에 위치합니다. 바닥글의 기본값 stacking order 은 1 입니다.

header, footerItem 및 Stacking Order in ListView 를참조하십시오 .

여기에는 footer 컴포넌트에서 만든 바닥글 항목이 포함됩니다.

각 뷰에 대해 바닥글 구성 요소의 인스턴스가 만들어집니다. 바닥글은 모든 항목 다음에 뷰의 끝에 위치합니다. 바닥글의 기본 stacking order 은 1 입니다.

footer, headerItem, Stacking Order in ListView 를참조하십시오 .

이 속성은 footer item 의 위치를 결정합니다.

이 프로퍼티는 Qt 5.4에 도입되었습니다.

이 프로퍼티는 헤더로 사용할 컴포넌트를 보유합니다.

헤더 컴포넌트의 인스턴스는 각 뷰에 대해 생성됩니다. 헤더는 뷰의 시작 부분, 항목 앞에 위치합니다. 헤더의 기본값 stacking order 은 1 입니다.

footer, headerItem, Stacking Order in ListView 를참조하세요 .

여기에는 header 컴포넌트에서 만든 헤더 항목이 들어 있습니다.

헤더 구성 요소의 인스턴스는 각 뷰에 대해 만들어집니다. 헤더는 뷰의 시작 부분, 모든 항목 앞에 위치합니다. 헤더의 기본값 stacking order 은 1 입니다.

header, footerItem, Stacking Order in ListView 를참조하세요 .

이 속성은 header item 의 위치를 결정합니다.

이 프로퍼티는 Qt 5.4에 도입되었습니다.

이 프로퍼티는 하이라이트로 사용할 컴포넌트를 보유합니다.

각 목록에 대해 하이라이트 컴포넌트의 인스턴스가 생성됩니다. 결과 컴포넌트 인스턴스의 지오메트리는 highlightFollowsCurrentItem 속성이 거짓이 아닌 한 현재 항목을 유지하도록 목록에 의해 관리됩니다. 하이라이트 항목의 기본값 stacking order 은 0 입니다.

highlightItem, highlightFollowsCurrentItem, ListView 하이라이트 예제 및 Stacking Order in ListView 를참조하세요 .

이 속성은 하이라이트가 뷰에서 관리되는지 여부를 보유합니다.

이 속성이 참(기본값)이면 하이라이트가 현재 항목을 따라 부드럽게 이동합니다. 그렇지 않으면 하이라이트가 뷰에 의해 이동되지 않으며 모든 이동은 하이라이트에 의해 구현되어야 합니다.

다음은 SpringAnimation 항목에 의해 동작이 정의된 하이라이트입니다:

Component {
    id: highlight
    Rectangle {
        width: 180; height: 40
        color: "lightsteelblue"; radius: 5
        y: list.currentItem.y
        Behavior on y {
            SpringAnimation {
                spring: 3
                damping: 0.2
            }
        }
    }
}

ListView {
    id: list
    width: 180; height: 200
    model: ContactModel {}
    delegate: Text { text: name }

    highlight: highlight
    highlightFollowsCurrentItem: false
    focus: true
}

하이라이트 애니메이션은 뷰가 스크롤되는 방식에도 영향을 줍니다. 이는 뷰가 기본 설정된 하이라이트 범위(또는 보이는 뷰포트) 내에서 하이라이트를 유지하기 위해 이동하기 때문입니다.

highlight 및 highlightMoveVelocity 을참조하십시오 .

여기에는 highlight 구성 요소에서 만든 하이라이트 항목이 보관됩니다.

highlightFollowsCurrentItem 을 false로 설정하지 않는 한 highlightItem 은 뷰에서 관리합니다. 하이라이트 항목의 기본값 stacking order 은 0 입니다.

highlight, highlightFollowsCurrentItem 및 Stacking Order in ListView도 참조하십시오 .

이 속성은 목록의 키 탐색이 활성화되어 있는지 여부를 보유합니다.

true 인 경우 사용자는 키보드로 뷰를 탐색할 수 있습니다. 마우스 및 키보드 상호 작용을 선택적으로 활성화 또는 비활성화해야 하는 애플리케이션에 유용합니다.

기본적으로 이 속성의 값은 기존 애플리케이션의 동작 호환성을 보장하기 위해 interactive 에 바인딩됩니다. 명시적으로 설정하면 대화형 속성에 바인딩되지 않습니다.

interactive 를참조하세요 .

이 속성은 목록이 키 탐색을 래핑할지 여부를 보유합니다.

이 속성이 참이면 현재 항목 선택을 목록의 끝으로 이동하는 키 탐색이 대신 래핑되어 선택 항목을 목록의 시작 부분으로 이동하며, 그 반대의 경우도 마찬가지입니다.

기본적으로 키 탐색은 래핑되지 않습니다.

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

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

이 속성을 설정해도 orientation 가 Qt.Vertical 인 경우 이 속성은 영향을 미치지 않습니다.

ListView::effectiveLayoutDirection 및 ListView::verticalLayoutDirection 을참조하십시오 .

이 속성은 목록에 데이터를 제공하는 모델을 보유합니다.

모델은 뷰의 항목을 만드는 데 사용되는 데이터 집합을 제공합니다. 모델은 ListModel, ObjectModel 을 사용하여 QML에서 직접 만들거나 C++ 모델 클래스에서 제공할 수 있습니다. C++ 모델 클래스를 사용하는 경우 QAbstractItemModel 의 하위 클래스이거나 간단한 목록이어야 합니다.

데이터 모델도참조하세요 .

이 속성은 뷰의 model 에서 이동 작업으로 인해 이동 중인 뷰의 항목에 적용할 전환을 보유합니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    move: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

model 에서 특정 인덱스 집합을 이동하는 이동 작업을 수행할 때마다 뷰의 각 항목이 1초 동안 뷰의 새 위치로 애니메이션됩니다. 전환은 모델에서 이동 작업의 대상이 되는 항목에만 적용되며, 이동 작업으로 인해 이동되는 그 아래 항목에는 적용되지 않습니다. 이동된 항목에 애니메이션을 적용하려면 displaced 또는 moveDisplaced 속성을 설정합니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

moveDisplaced 및 ViewTransition도 참조하세요 .

이 속성은 뷰의 model 에서 이동 작업으로 인해 이동된 항목에 적용할 전환을 보유합니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    moveDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

model 에서 특정 인덱스 집합을 이동하는 이동 작업을 수행할 때마다 이동 작업의 원본 인덱스와 대상 인덱스 사이의 항목이 이동되어 뷰 내에서 위쪽 또는 아래쪽(가로 방향인 경우 옆으로)으로 이동하게 됩니다. 이 이동이 발생하면 지정된 대로 뷰 내에서 항목이 새 x,y 위치로 이동하면 1초 동안 NumberAnimation 애니메이션이 적용됩니다. 이 전환은 이동 작업의 실제 대상인 항목에는 적용되지 않으며, 이동된 항목에 애니메이션을 적용하려면 move 속성을 설정합니다.

항목이 동시에 여러 유형의 작업에 의해 이동되는 경우 addDisplaced, moveDisplaced 또는 removeDisplaced 전환이 적용될지 여부는 정의되지 않습니다. 또한 항목이 추가, 이동 또는 제거 작업에 의해 대체되는지 여부에 따라 다른 전환을 지정할 필요가 없는 경우 displaced 속성을 대신 설정하는 것이 좋습니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

displaced, move, ViewTransition도 참조하세요 .

이 속성은 목록의 방향을 유지합니다.

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

Constant	설명
ListView.Horizontal	항목이 가로로 배치됩니다.
ListView.Vertical	(기본값) 항목이 세로로 배치됩니다.

Flickable Direction 를참조하십시오 .

이 속성은 뷰에 대해 처음에 만든 항목에 적용할 전환을 보유합니다.

언제 생성되는 모든 항목에 적용됩니다:

• 뷰가 처음 만들어지는 경우
• 뷰의 model 이 표시되는 델리게이트가 완전히 바뀌는 방식으로 변경되는 경우
• 모델이 QAbstractItemModel 하위 클래스인 경우 뷰의 model 는 reset 입니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    populate: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

뷰가 초기화되면 뷰에 필요한 모든 항목을 만든 다음 1초에 걸쳐 뷰 내에서 올바른 위치로 애니메이션을 적용합니다.

그러나 나중에 뷰를 스크롤할 때 델리게이트가 표시될 때 인스턴스화되더라도 채우기 전환이 실행되지 않습니다. 새 델리게이트가 표시되는 방식으로 모델이 변경되면 add 전환이 실행됩니다. 따라서 populate 전환이 모든 델리게이트에 적용되는 것은 아니므로 델리게이트의 프로퍼티를 초기화할 때 전환에 의존해서는 안 됩니다. 애니메이션이 속성의 to 값을 설정하는 경우 속성은 처음에 to 값을 가져야 하며, 애니메이션이 애니메이션인 경우 from 값을 설정해야 합니다:

ListView {
    ...
    delegate: Rectangle {
        opacity: 1 // not necessary because it's the default
    }
    populate: Transition {
        NumberAnimation { property: "opacity"; from: 0; to: 1; duration: 1000 }
    }
}

보기 전환을 사용하는 방법에 대한 자세한 내용과 예제는 ViewTransition 문서를 참조하세요.

add 및 ViewTransition 을참조하세요 .

이 속성은 뷰에서 제거되는 항목에 적용할 전환을 보유합니다.

예를 들어 다음은 이러한 전환을 지정하는 보기입니다:

ListView {
    ...
    remove: Transition {
        ParallelAnimation {
            NumberAnimation { property: "opacity"; to: 0; duration: 1000 }
            NumberAnimation { properties: "x,y"; to: 100; duration: 1000 }
        }
    }
}

위 뷰에서 항목이 제거될 때마다 항목이 1초에 걸쳐 위치(100,100)로 애니메이션되고 동시에 불투명도 0으로 변경됩니다. 이 전환은 뷰에서 제거된 항목에만 적용되며 항목 제거로 인해 이동된 그 아래 항목에는 적용되지 않습니다. 이동된 항목에 애니메이션을 적용하려면 displaced 또는 removeDisplaced 속성을 설정합니다.

전환이 적용될 때 항목은 이미 모델에서 제거되어 있으므로 제거된 인덱스에 대한 모델 데이터에 대한 참조는 유효하지 않습니다.

또한 델리게이트 항목에 delayRemove 첨부 속성이 설정되어 있는 경우 delayRemove 이 다시 거짓이 될 때까지 제거 전환이 적용되지 않습니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

removeDisplaced 및 ViewTransition도 참조하세요 .

이 속성은 뷰의 다른 항목이 제거되어 대체되는 뷰의 항목에 적용할 전환을 유지합니다.

예를 들어 다음은 이러한 전환을 지정하는 뷰입니다:

ListView {
    ...
    removeDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

위 뷰에서 항목이 제거될 때마다 그 아래의 모든 항목이 이동되어 뷰 내에서 위쪽(가로 방향인 경우 옆쪽)으로 이동합니다. 이 이동이 발생하면 지정된 대로 뷰 내에서 항목이 새 x,y 위치로 이동하면 1초 동안 NumberAnimation 애니메이션이 적용됩니다. 이 전환은 뷰에서 실제로 제거된 항목에는 적용되지 않으며, 제거된 항목에 애니메이션을 적용하려면 remove 속성을 설정합니다.

항목이 동시에 여러 유형의 작업에 의해 이동되는 경우 addDisplaced, moveDisplaced 또는 removeDisplaced 전환이 적용될지 여부는 정의되지 않습니다. 또한 항목이 추가, 이동 또는 제거 작업에 의해 대체되는지 여부에 따라 다른 전환을 지정할 필요가 없는 경우 displaced 속성을 대신 설정하는 것이 좋습니다.

보기 전환을 사용하는 방법에 대한 자세한 내용과 예는 ViewTransition 문서를 참조하세요.

displaced, remove, ViewTransition도 참조하세요 .

이 속성을 사용하면 delegate 에서 인스턴스화된 항목을 재사용할 수 있습니다. false 으로 설정하면 현재 풀링된 항목이 모두 삭제됩니다.

이 속성은 기본적으로 false 입니다.

Reusing items, pooled() 및 reused()도 참조하세요 .

이러한 속성은 평가할 표현식과 섹션 레이블의 모양을 결정합니다.

section.property 각 섹션의 기준이 되는 속성의 이름을 보유합니다.

section.criteria section.property 을 기준으로 각 섹션을 구성하는 기준을 보유합니다. 이 값은 다음 중 하나 일 수 있습니다:

섹션 경계를 결정할 때 대소문자를 구분하지 않는 비교가 사용됩니다.

section.delegate 는 각 섹션에 대한 델리게이트 컴포넌트를 보유합니다. 섹션 델리게이트 인스턴스의 기본 stacking order 은 2 입니다. 여기에 "section"이라는 required 속성을 선언하면 해당 속성에는 섹션의 제목이 포함됩니다.

section.labelPositioning 현재 및/또는 다음 섹션 레이블이 뷰의 시작/끝에 붙어 있는지 여부와 레이블이 인라인으로 표시되는지 여부를 결정합니다. 이 값은 다음의 조합일 수 있습니다:

목록의 각 항목에는 ListView.section, ListView.previousSection 및 ListView.nextSection 이라는 이름의 속성이 첨부되어 있습니다.

예를 들어 다음은 동물 목록을 섹션으로 구분하여 표시하는 ListView 입니다. ListView 의 각 항목은 모델 항목의 "크기" 속성에 따라 다른 섹션에 배치됩니다. sectionHeading 델리게이트 컴포넌트는 각 섹션의 시작을 표시하는 하늘색 막대를 제공합니다.

    // The delegate for each section header
    Component {
        id: sectionHeading
        Rectangle {
            width: ListView.view.width
            height: childrenRect.height
            color: "lightsteelblue"

            required property string section

            Text {
                text: parent.section
                font.bold: true
                font.pixelSize: 20
            }
        }
    }

    ListView {
        id: view
        anchors.top: parent.top
        anchors.bottom: buttonBar.top
        width: parent.width
        model: animalsModel
        delegate: Text {
            required property string name

            text: name
            font.pixelSize: 18
        }

        section.property: "size"
        section.criteria: ViewSection.FullString
        section.delegate: sectionHeading
    }

ListView 예제 및 Stacking Order in ListView 를참조하십시오 .

이 속성은 드래그 또는 플릭 후 뷰 스크롤이 고정되는 방식을 결정합니다. 가능한 값은 다음과 같습니다:

snapMode 는 currentIndex 에 영향을 주지 않습니다. 목록이 이동될 때 currentIndex 을 업데이트하려면 highlightRangeMode 을 ListView.StrictlyEnforceRange 으로 설정하세요.

highlightRangeMode 를참조하세요 .

이 속성은 항목 사이의 간격을 유지합니다.

기본값은 0입니다.

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

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

orientation 이 Qt.Horizontal인 경우 이 속성을 설정해도 효과가 없습니다.

ListView::layoutDirection 를참조하십시오 .

이 첨부 프로퍼티는 델리게이트가 소멸될 수 있는지 여부를 저장합니다. 델리게이트의 각 인스턴스에 첨부됩니다. 기본값은 거짓입니다.

애니메이션이 완료될 때까지 항목의 소멸을 지연시켜야 하는 경우가 있습니다. 아래 예제 델리게이트는 목록에서 항목이 제거되기 전에 애니메이션이 완료되도록 합니다.

Component {
    id: delegate
    Item {
        SequentialAnimation {
            id: removeAnimation
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: true }
            NumberAnimation { target: wrapper; property: "scale"; to: 0; duration: 250; easing.type: Easing.InOutQuad }
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: false }
        }
        ListView.onRemove: removeAnimation.start()
    }
}

remove 전환이 지정된 경우 지연 제거가 false 로 반환될 때까지 적용되지 않습니다.

이 연결된 속성은 이 델리게이트가 현재 항목인 경우 참이고, 그렇지 않으면 거짓입니다.

델리게이트의 각 인스턴스에 첨부됩니다.

이 속성은 예를 들어 현재 항목의 모양을 조정하는 데 사용할 수 있습니다:

ListView {
    width: 180; height: 200

    Component {
        id: contactsDelegate
        Rectangle {
            id: wrapper
            width: 180
            height: contactInfo.height
            color: ListView.isCurrentItem ? "black" : "red"
            Text {
                id: contactInfo
                text: name + ": " + number
                color: wrapper.ListView.isCurrentItem ? "red" : "black"
            }
        }
    }

    model: ContactModel {}
    delegate: contactsDelegate
    focus: true
}

이 연결된 속성은 다음 요소의 섹션을 보유합니다.

델리게이트의 각 인스턴스에 첨부됩니다.

섹션은 section 속성을 사용하여 평가됩니다.

이 첨부된 속성은 이전 요소의 섹션을 보유합니다.

델리게이트의 각 인스턴스에 첨부됩니다.

섹션은 section 속성을 사용하여 평가됩니다.

이 연결된 속성은 이 요소의 섹션을 보유합니다.

델리게이트의 각 인스턴스에 첨부됩니다.

섹션은 section 속성을 사용하여 평가됩니다.

이 첨부된 속성은 이 델리게이트 인스턴스를 관리하는 보기를 보유합니다.

델리게이트의 각 인스턴스와 머리글, 바닥글, 섹션 및 하이라이트 델리게이트에도 첨부됩니다.

이 첨부된 신호는 항목이 뷰에 추가된 직후에 발생합니다.

추가 전환이 지정된 경우 이 신호가 처리된 후 즉시 적용됩니다.

이 신호는 항목이 재사용 풀에 추가된 후에 발생합니다. 이 신호를 사용하여 항목 내에서 진행 중인 타이머나 애니메이션을 일시 중지하거나 재사용할 수 없는 리소스를 확보할 수 있습니다.

이 신호는 reuseItems 속성이 true 인 경우에만 발생합니다.

Reusing items, reuseItems, reused()도 참조하세요 .

이 연결된 신호는 뷰에서 항목이 제거되기 직전에 발생합니다.

제거 전환이 지정된 경우 delayRemove 이 거짓인 경우 이 신호가 처리된 후에 적용됩니다.

이 신호는 항목이 재사용된 후에 발생합니다. 이 시점에서 항목이 풀에서 꺼내져 콘텐츠 보기 내부에 배치되고 index 및 row 같은 모델 속성이 업데이트됩니다.

모델에서 제공하지 않는 다른 속성은 항목이 재사용될 때 변경되지 않습니다. 델리게이트 내부에 상태를 저장하지 않는 것이 좋지만, 저장하는 경우 이 신호를 수신하면 해당 상태를 수동으로 재설정하세요.

이 신호는 항목을 처음 만들 때가 아니라 항목을 재사용할 때 발생합니다.

이 신호는 reuseItems 속성이 true 인 경우에만 발생합니다.

Reusing items, reuseItems, pooled()도 참조하세요 .

머리글 또는 바닥글을 고려하여 뷰를 시작 또는 끝에 배치합니다.

contentX 또는 contentY 을 사용하여 특정 인덱스에 뷰를 배치하는 것은 권장하지 않습니다. 목록의 시작 부분에서 항목을 제거해도 다른 모든 항목의 위치가 변경되지 않고, 델리게이트의 크기에 따라 뷰의 실제 시작 부분이 달라질 수 있기 때문에 이 방법은 신뢰할 수 없습니다.

참고: 메서드는 컴포넌트가 완료된 후에만 호출해야 합니다. 시작 시 뷰의 위치를 변경하려면 이 메서드를 Component.onCompleted에서 호출해야 합니다. 예를 들어 시작 시 뷰를 끝에 배치하려면 다음과 같이 하세요:

Component.onCompleted: positionViewAtEnd()

현재 인덱스를 감소시킵니다. keyNavigationWraps 이 참이고 현재 인덱스가 처음에 있는 경우 현재 인덱스가 래핑됩니다. count 이 0이면 이 메서드는 아무런 영향을 미치지 않습니다.

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

모델 변경에 대한 응답은 일반적으로 프레임당 한 번만 발생하도록 일괄 처리됩니다. 즉, 스크립트 블록 내부에서 기본 모델이 변경되었지만 ListView 이 아직 따라잡지 못했을 수 있습니다.

이 메서드는 ListView 이 모델의 미결 변경 사항에 즉시 응답하도록 합니다.

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

현재 인덱스를 증가시킵니다. keyNavigationWraps 이 참이고 현재 인덱스가 끝에 있는 경우 현재 인덱스가 래핑됩니다. count 이 0이면 이 메서드는 아무런 영향을 미치지 않습니다.

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

콘텐츠 좌표에서 x, y 지점을 포함하는 보이는 항목의 인덱스를 반환합니다. 지정된 지점에 항목이 없거나 항목이 표시되지 않으면 -1이 반환됩니다.

항목이 보이는 영역 밖에 있으면 스크롤하여 보기로 이동했을 때 해당 지점에 항목이 존재하는지 여부와 관계없이 -1이 반환됩니다.

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

콘텐츠 좌표에서 x, y 지점을 포함하는 보이는 항목을 반환합니다. 지정된 지점에 항목이 없거나 항목이 표시되지 않으면 null이 반환됩니다.

항목이 보이는 영역 밖에 있으면 스크롤하여 보기로 이동했을 때 해당 지점에 항목이 존재하는지 여부에 관계없이 null이 반환됩니다.

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

index 에 대한 항목을 반환합니다. 해당 인덱스에 대한 항목이 없는 경우(예: 아직 생성되지 않았거나 표시 영역에서 패닝되어 캐시에서 제거되었기 때문)에는 null이 반환됩니다.

참고: 이 메서드는 컴포넌트가 완료된 후에만 호출해야 합니다. 또한 뷰가 해당 항목을 해제하는 경우 컨트롤이 호출 범위를 벗어나는 즉시 null로 바뀔 수 있으므로 반환된 값은 저장해서는 안 됩니다.

index 이 mode 에 지정된 위치에 위치하도록 뷰를 배치합니다:

index 에 뷰를 배치하면 뷰의 시작 또는 끝에 빈 공간이 표시되는 경우 뷰가 경계에 배치됩니다.

contentX 또는 contentY 을 사용하여 특정 인덱스에 뷰를 배치하는 것은 권장하지 않습니다. 목록의 시작 부분에서 항목을 제거해도 다른 모든 항목의 위치가 변경되지 않고 위임자의 크기에 따라 뷰의 실제 시작 부분이 달라질 수 있기 때문에 이 방법은 신뢰할 수 없습니다. 항목을 보기로 가져오는 올바른 방법은 positionViewAtIndex 을 사용하는 것입니다.

참고: 메서드는 컴포넌트가 완료된 후에만 호출해야 합니다. 시작 시 뷰의 위치를 지정하려면 이 메서드를 Component.onCompleted에서 호출해야 합니다. 예를 들어 뷰를 끝에 배치하려면:

Component.onCompleted: positionViewAtIndex(count - 1, ListView.Beginning)