ScrollView QML Type

Scrollable view. 更多...

导入语句：	import QtQuick.Controls 2.2
Since:	Qt 5.9
继承：	Control

所有成员列表，包括继承成员

特性

contentChildren : list<Item>
contentData : list<Object>
contentHeight : real
contentWidth : real

详细描述

ScrollView provides scrolling for user-defined content. It can be used to either replace a Flickable , or to decorate an existing one.

The first example demonstrates the simplest usage of ScrollView .

ScrollView {
    width: 200
    height: 200
    clip: true
    Label {
        text: "ABC"
        font.pixelSize: 224
    }
}

注意： ScrollView does not automatically clip its contents. If it is not used as a full-screen item, you should consider setting the clip 特性到 true , as shown above.

The second example illustrates using an existing Flickable , that is, a ListView .

ScrollView {
    width: 200
    height: 200
    ListView {
        model: 20
        delegate: ItemDelegate {
            text: "Item " + index
        }
    }
}

滚动条

The horizontal and vertical scroll bars can be accessed and customized using the ScrollBar.horizontal and ScrollBar.vertical attached properties. The following example adjusts the scroll bar policies so that the horizontal scroll bar is always off, and the vertical scroll bar is always on.

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

Touch vs. Mouse Interaction

On touch, ScrollView enables flicking and makes the scroll bars non-interactive.

When interacted with a mouse device, flicking is disabled and the scroll bars are interactive.

Scroll bars can be made interactive on touch, or non-interactive when interacted with a mouse device, by setting the interactive property explicitly to true or false ，分别。

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

另请参阅 ScrollBar , ScrollIndicator , Customizing ScrollView ，和容器控件 .

特性文档编制

contentChildren : list < Item >

This property holds the list of content children.

The list contains all items that have been declared in QML as children of the view.

注意： 不像 contentData , contentChildren does not include non-visual QML objects.

另请参阅 Item::children and contentData .

[default] contentData : list < Object >

This property holds the list of content data.

The list contains all objects that have been declared in QML as children of the view.

注意： 不像 contentChildren , contentData does include non-visual QML objects.

另请参阅 Item::data and contentChildren .

contentHeight : real

This property holds the height of the scrollable content.

If only a single item is used within a ScrollView , the content size is automatically calculated based on the implicit size of its contained item.

另请参阅 contentWidth .

contentWidth : real

This property holds the width of the scrollable content.

If only a single item is used within a ScrollView , the content size is automatically calculated based on the implicit size of its contained item.

另请参阅 contentHeight .