ScrollView QML Type

스크롤 가능한 보기. 더 보기...

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

속성

• contentChildren : list<Item>
• contentData : list<QtObject>
• effectiveScrollBarHeight : real (since 6.6)
• effectiveScrollBarWidth : real (since 6.6)

상세 설명

ScrollView는 사용자 정의 콘텐츠에 대한 스크롤 기능을 제공합니다. 이 컴포넌트는 Flickable 을 대체하거나, 기존 컴포넌트를 꾸미는 데 사용할 수 있습니다.

첫 번째 예제는 ScrollView의 가장 간단한 사용법을 보여줍니다.

ScrollView {
    width: 200
    height: 200

    Label {
        text: "ABC"
        font.pixelSize: 224
    }
}

두 번째 예제는 기존 ` Flickable`, 즉 ` ListView`을 사용하는 방법을 보여줍니다.

ScrollView {
    width: 200
    height: 200

    ListView {
        model: 20
        delegate: ItemDelegate {
            text: "Item " + index

            required property int index
        }
    }
}

크기 조정

Flickable과 마찬가지로, ScrollView를 사용할 때 유의해야 할 몇 가지 사항이 있습니다:

• ScrollView 내에 단 하나의 항목만 사용되는 경우, 콘텐츠 크기는 포함된 항목의 암시적 크기를 기반으로 자동으로 계산됩니다. 그러나 두 개 이상의 항목이 사용되거나(또는 암시적 크기가 제공되지 않는 경우), ` contentWidth ` 및 ` contentHeight ` 속성을 포함된 항목들의 합계 크기로 설정해야 합니다.
• 콘텐츠 크기가 ScrollView의 크기 이하인 경우, 스크롤할 수 없습니다.
• ScrollView가 수직 방향으로만 스크롤되도록 하려면 contentWidth 를 availableWidth 에 바인딩할 수 있습니다(contentHeight의 경우 그 반대의 방식으로 바인딩). 이렇게 하면 패딩이나 스크롤바를 고려하여 콘텐츠가 ScrollView 내부의 사용 가능한 수평 공간을 모두 채우게 됩니다.

스크롤 막대

ScrollBar.horizontal 및 ScrollBar.vertical 부착 속성을 사용하여 가로 및 세로 스크롤 막대에 접근하고 사용자 지정할 수 있습니다. 다음 예제는 가로 스크롤 막대가 항상 비활성화되고 세로 스크롤 막대가 항상 활성화되도록 스크롤 막대 정책을 조정합니다.

ScrollView {
    // ...
    ScrollBar.horizontal.policy: ScrollBar.AlwaysOff
    ScrollBar.vertical.policy: ScrollBar.AlwaysOn
}

터치 대 마우스 상호작용

터치 시 ScrollView는 플릭 기능을 활성화하고 스크롤 막대를 비활성화합니다.

마우스 장치로 상호작용할 때는 플릭 동작이 비활성화되고 스크롤 막대가 상호작용 가능한 상태가 됩니다.

interactive 속성을 각각 true 또는 false 로 명시적으로 설정하여, 터치 시에는 스크롤 막대를 상호작용 가능하게 하고, 마우스 장치로 상호작용할 때는 상호작용 불가능하게 만들 수 있습니다.

ScrollView {
    // ...
    ScrollBar.horizontal.interactive: true
    ScrollBar.vertical.interactive: true
}

변동되는 델리게이트 크기

델리게이트 크기가 다양하면 새로운 델리게이트가 뷰에 로드될 때 ScrollBar 가 “이리저리 튕겨 다니는” 현상이 발생할 수 있습니다. 이러한 이유로 델리게이트 크기를 모두 동일하게 유지하는 것이 권장됩니다. 자세한 내용은 Variable Delegate Size and Section Labels 를 참조하십시오.

ScrollBar, ScrollIndicator, Qt Quick Controls 의 ‘스크롤 뷰, 컨테이너 컨트롤 및 포커스 관리 사용자 지정’항목도 참조하십시오 .

속성 설명서

contentChildren : list<Item>

이 속성은 콘텐츠 자식 요소들의 목록을 포함합니다.

이 목록에는 QML에서 뷰의 자식으로 선언된 모든 항목이 포함됩니다.

Item::children 및 contentData도 참조하십시오 .

contentData : list<QtObject> [default]

이 속성은 콘텐츠 데이터 목록을 포함합니다.

이 목록에는 QML에서 뷰의 자식 객체로 선언된 모든 객체가 포함됩니다.

Item::data 및 contentChildren도 참조하십시오 .

effectiveScrollBarHeight : real [since 6.6]

이 속성은 수평 스크롤바의 유효 높이를 나타냅니다. 스크롤바가 표시되어 있을 때, 이 속성은 스크롤바의 현재 높이를 나타냅니다. 스크롤바가 표시되지 않거나 정책이 ` QQuickScrollBar::AlwaysOff`로 설정되어 있을 때, 이 속성은 ` 0`입니다.

이 속성은 Qt 6.6에서 도입되었습니다.

ScrollBar::policy도 참조하십시오 .

effectiveScrollBarWidth : real [since 6.6]

이 속성은 수직 스크롤바의 유효 너비를 나타냅니다. 스크롤바가 표시되어 있을 때, 이 속성은 스크롤바의 현재 너비를 나타냅니다. 스크롤바가 표시되지 않거나 정책이 ` QQuickScrollBar::AlwaysOff`로 설정되어 있을 때, 이 속성은 ` 0`입니다.

이 속성은 Qt 6.6에서 도입되었습니다.

ScrollBar::policy도 참조하십시오 .