PathView QML Type

이러한 속성은 뷰 내에서 하이라이트(현재 항목)의 기본 설정 범위를 설정합니다. 기본값은 0 ~ 1 범위여야 합니다.

유효한 값은 highlightRangeMode 입니다:

기본값은 PathView.StrictlyEnforceRange입니다.

하이라이트 범위를 정의하는 것이 뷰가 이동할 때 현재 항목이 끝나는 위치에 영향을 미치는 올바른 방법입니다. 예를 들어 현재 선택된 항목이 경로의 중간에 위치하도록 하려면 하이라이트 범위를 0.5,0.5로 설정하고 highlightRangeMode 을 PathView.StrictlyEnforceRange로 설정합니다. 그러면 경로가 스크롤될 때 현재 선택된 항목이 해당 위치에 있는 항목이 됩니다. 이는 현재 선택된 항목이 변경될 때도 적용되며, 기본 설정된 강조 표시 범위 내로 스크롤됩니다. 또한 현재 항목 인덱스의 동작은 하이라이트가 존재하는지 여부에 관계없이 발생합니다.

이 속성은 경로에서 캐시할 최대 항목 수를 보유합니다.

예를 들어, 20개의 항목이 포함된 모델 PathView, pathItemCount 10, cacheItemCount 4인 경우 최대 14개의 항목이 생성되며, 10개는 경로에 표시되고 4개는 보이지 않는 캐시된 항목이 됩니다.

캐시된 델리게이트는 비동기적으로 생성되므로 여러 프레임에 걸쳐 생성할 수 있고 프레임을 건너뛸 가능성이 줄어듭니다.

pathItemCount 를참조하세요 .

이 속성은 모델의 항목 수를 보유합니다.

이 속성은 현재 항목의 인덱스를 보유합니다.

이 속성은 뷰의 현재 항목을 보유합니다.

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

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

PathView 은 델리게이트의 루트 항목의 크기에 따라 항목을 레이아웃한다는 점에 유의하세요.

다음은 델리게이트의 예시입니다:

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

이 속성은 마우스 드래그를 시작하는 경로로부터의 최대 거리를 보유합니다.

기본적으로 경로는 항목을 클릭해야만 드래그할 수 있습니다. dragMargin이 0보다 크면 경로의 dragMargin 픽셀 내에서 클릭하여 드래그를 시작할 수 있습니다.

이 속성은 사용자가 뷰를 드래그하여 뷰가 현재 이동 중인지 여부를 유지합니다.

이 속성은 플릭이 감속되는 속도를 보유합니다.

기본값은 100입니다.

이 속성은 사용자가 뷰를 플릭하여 뷰가 현재 이동 중인지 여부를 보유합니다.

이 속성은 하이라이트로 사용할 컴포넌트를 보유합니다.

각 뷰에 대해 하이라이트 컴포넌트의 인스턴스가 생성됩니다. 결과 컴포넌트 인스턴스의 지오메트리는 현재 항목을 유지하도록 뷰에서 관리됩니다.

아래 예는 간단한 하이라이트를 만드는 방법을 보여줍니다. 경로에서 멀어지면 하이라이트가 숨겨지도록 하기 위해 PathView.onPath 첨부 속성을 사용하는 것에 주목하세요.

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

highlightItem 및 highlightRangeMode도 참조하세요 .

highlightItem 는 highlight 컴포넌트에서 생성된 하이라이트 항목을 보유합니다.

highlight도 참조하세요 .

이 속성은 하이라이트 델리게이트의 이동 애니메이션 지속 시간을 보유합니다.

highlightRangeMode 가 StrictlyEnforceRange인 경우 이 속성은 항목이 경로를 따라 이동하는 속도를 결정합니다.

지속 시간의 기본값은 300밀리초입니다.

사용자는 인터랙티브하지 않은 PathView 을 드래그하거나 플릭할 수 없습니다.

이 속성은 일시적으로 플릭을 비활성화하는 데 유용합니다. 이를 통해 PathView 의 하위 항목과 특별한 상호 작용이 가능합니다.

이 속성은 사용자가 뷰를 쓸어 넘길 수 있는 대략적인 최대 속도를 초당 픽셀 단위로 보유합니다.

기본값은 플랫폼에 따라 다릅니다.

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

모델은 뷰의 항목을 만드는 데 사용되는 데이터 집합을 제공합니다. 대규모 또는 동적 데이터 집합의 경우 모델은 일반적으로 C++ 모델 개체에 의해 제공됩니다. 모델은 ListModel 유형을 사용하여 QML에서 직접 만들 수도 있습니다.

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

이 속성은 현재 인덱스를 설정할 때 항목이 이동하는 방향을 결정합니다. 가능한 값은 다음과 같습니다:

예를 들어 모델에 5개의 항목이 있고 currentIndex 이 0 이라고 가정합니다. currentIndex 이 2 으로 설정되어 있다고 가정합니다,

• 로 설정하면 Positive 이동 방향은 다음과 같은 순서가 됩니다: 0, 1, 2
• Negative 이동 방향은 다음과 같은 순서가 됩니다: 0, 5, 4, 3, 2
• Shortest 이동 방향은 Positive 과 같은 순서가 됩니다.

이 속성은 사용자가 뷰를 드래그하거나 플릭하여 뷰가 현재 이동 중인지 여부를 유지합니다.

오프셋은 항목이 초기 위치에서 경로를 따라 얼마나 멀리 떨어져 있는지를 지정합니다. 이 값은 0 에서 모델 내 항목 수까지 범위의 실수입니다.

이 속성은 항목을 레이아웃하는 데 사용되는 경로를 보유합니다. 자세한 내용은 Path 문서를 참조하세요.

이 속성은 한 번에 경로에 표시되는 항목의 수를 보유합니다.

pathItemCount를 정의되지 않음으로 설정하면 경로에 있는 모든 항목이 표시됩니다.

이 속성은 드래그 또는 플릭 후 항목이 정렬되는 방식을 결정합니다. 가능한 값은 다음과 같습니다:

snapMode 는 currentIndex 에 영향을 주지 않습니다. 보기가 이동될 때 currentIndex 을 업데이트하려면 highlightRangeMode 을 PathView.StrictlyEnforceRange 으로 설정합니다(기본값은 PathView).

highlightRangeMode 를참조하세요 .

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

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

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

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

이 첨부 속성은 항목이 현재 경로에 있는지 여부를 보유합니다.

pathItemCount 가 설정된 경우 일부 항목이 인스턴스화되었지만 현재 경로에 있는 것으로 간주되지 않을 수 있습니다. 일반적으로 이러한 항목은 예를 들어 보이지 않게 설정됩니다:

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

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

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

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

이 신호는 사용자가 뷰 드래그를 중지할 때 발생합니다.

터치/마우스 버튼에서 손을 뗄 때 드래그 속도가 충분하면 플릭이 시작됩니다.

이 신호는 사용자 상호 작용으로 인해 뷰가 드래그되기 시작할 때 발생합니다.

이 신호는 뷰가 플릭으로 인해 이동이 중지될 때 발생합니다.

이 신호는 뷰를 플릭할 때 발생합니다. 플릭은 마우스 또는 터치가 움직이고 있는 동안 마우스 또는 터치를 놓는 지점부터 시작됩니다.

이 신호는 사용자 상호 작용으로 인해 뷰가 움직이지 않을 때 발생합니다. 플릭이 생성된 경우 플릭이 중지되면 이 신호가 발생합니다. 플릭이 생성되지 않은 경우 사용자가 드래그를 중지할 때(예: 마우스 또는 터치 해제) 이 신호가 발생합니다.

이 신호는 사용자 상호 작용으로 인해 뷰가 움직이기 시작할 때 발생합니다.

현재 인덱스를 감소시킵니다.

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

현재 인덱스를 증가시킵니다.

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

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

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

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

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

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

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

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

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

Component.onCompleted: positionViewAtIndex(count - 1, PathView.End)