C

SwipeView QML 类型

允许用户通过横向滑动来导航页面。 更多...

导入语句import QtQuick.Controls
自Qt Quick Ultralite 1.0
继承

Control

属性

方法

详细描述

SwipeView 提供了一个基于滑动导航的模型。

SwipeView 中填充了一组页面。一次只能显示一个页面。用户可以通过横向滑动来在页面之间进行导航。请注意，SwipeView 自身完全是不可视的。

SwipeView{
    id: theSwipe
    width: 150; height: 150
    clip: true
    Rectangle
    {
        color: "red"
    }
    Rectangle
    {
        color: "yellow"
    }
    Rectangle
    {
        color: "lightGreen"
    }
}

如上图所示，SwipeView 中填充了一组静态页面，这些页面作为视图的直接子代被定义。

通常不建议在 SwipeView 中添加过多的页面。然而，当页面的数量增加，或者单个页面相对复杂时，可能需要通过卸载用户无法直接触及的页面来释放资源。请参阅Qt Quick Ultralite 性能指南中动态加载组件的部分。

注意：SwipeView 会接管视图中添加的项目的几何管理。不支持在项目中使用锚点，任何对 width 或 height 的分配都会被视图覆盖。请注意，这仅适用于项目的根节点。指定宽度和高度，或对其子代使用锚点按预期工作。

注意：SwipeView 基于 QtQuick.Templates::SwipeView，它要求 contentItem 是一个 Flickable。不支持使用任何其他 contentItem。

参阅 控件样式.

属性文档

[只读] count : int

此属性包含 SwipeView 中的页面数。

参阅 currentIndex.


currentIndex : int

此属性包含当前可见项的索引。它可以用来自动滚动到特定的页面。

参阅 currentItem.


[只读] currentItem : Item

此属性包含当前可见的项。

参阅 currentIndex.


interactive : bool

此属性描述用户是否可以与 SwipeView 进行交互。用户无法滑动非交互视图。

默认值为 true。


orientation : enumeration

此属性包含方向。

可能的值

常量描述
Qt.Horizontal水平 (默认)
Qt.Vertical垂直

方法文档

void decrementCurrentIndex()

这会将当前页面更改为索引较低的页面。

参阅 currentIndex、incrementCurrentIndex 和 setCurrentIndex。


void incrementCurrentIndex()

这会将当前页面更改为索引较高的页面。

参阅 currentIndex、decrementCurrentIndex 和 setCurrentIndex。


void setCurrentIndex(int index)

这会将当前页面更改为给定 index 的页面。

参阅 currentIndex、decrementCurrentIndex 和 incrementCurrentIndex。


在特定 Qt 许可下可用。
了解更多信息。