SwipeView QML Type

Enables the user to navigate pages by swiping sideways. 更多...

import 语句：	import QtQuick.Controls 2.2
Since:	Qt 5.7
继承：	容器

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

特性

interactive : bool
orientation : enumeration

附加特性

index : int
isCurrentItem : bool
isNextItem : bool
isPreviousItem : bool
view : SwipeView

详细描述

SwipeView provides a swipe-based navigation model.

SwipeView is populated with a set of pages. One page is visible at a time. The user can navigate between the pages by swiping sideways. Notice that SwipeView itself is entirely non-visual. It is recommended to combine it with PageIndicator , to give the user a visual clue that there are multiple pages.

SwipeView {
    id: view
    currentIndex: 1
    anchors.fill: parent
    Item {
        id: firstPage
    }
    Item {
        id: secondPage
    }
    Item {
        id: thirdPage
    }
}
PageIndicator {
    id: indicator
    count: view.count
    currentIndex: view.currentIndex
    anchors.bottom: view.bottom
    anchors.horizontalCenter: parent.horizontalCenter
}

As shown above, SwipeView is typically populated with a static set of pages that are defined inline as children of the view. It is also possible to add , insert , move ，和 remove pages dynamically at run time.

It is generally not advisable to add excessive amounts of pages to a SwipeView . However, when the amount of pages grows larger, or individual pages are relatively complex, it may be desired free up resources by unloading pages that are outside the reach. The following example presents how to use Loader to keep a maximum of three pages simultaneously instantiated.

SwipeView {
    Repeater {
        model: 6
        Loader {
            active: SwipeView.isCurrentItem || SwipeView.isNextItem || SwipeView.isPreviousItem
            sourceComponent: Text {
                text: index
                Component.onCompleted: console.log("created:", index)
                Component.onDestruction: console.log("destroyed:", index)
            }
        }
    }
}

注意： SwipeView takes over the geometry management of items added to the view. Using anchors on the items is not supported, and any width or height assignment will be overridden by the view. Notice that this only applies to the root of the item. Specifying width and height, or using anchors for its children works as expected.

另请参阅 TabBar , PageIndicator , Customizing SwipeView , 导航控件，和容器控件 .

特性文档编制

interactive : bool

This property describes whether the user can interact with the SwipeView . The user cannot swipe a view that is not interactive.

默认值为 true .

This QML property was introduced in QtQuick.Controls 2.1 (Qt 5.8).

orientation : enumeration

This property holds the orientation.

可能的值：

常量	描述
`Qt.Horizontal`	Horizontal (default)
`Qt.Vertical`	Vertical

This QML property was introduced in QtQuick.Controls 2.2 (Qt 5.9).