StackView QML Type

该属性显示过渡是否正在运行。

该属性显示当前堆栈中最顶端的项目。

该属性显示当前推入堆栈的项目数。

该属性显示堆栈是否为空。

此属性在 QtQuick.Controls 2.3 (Qt 5.10) 中引入。

另请参阅 depth 。

该属性用于保存创建StackView 时应显示的初始项。初始项可以是Item,Component, 或url 。指定初始项等同于：

Component.onCompleted: stackView.push(myInitialItem)

另请参阅 push() 。

此属性保存当另一个项目从堆栈中弹出时应用于进入堆栈的项目的过渡。

另请参阅 自定义 StackView。

该属性用于保存从堆栈中弹出时应用于退出堆栈的项目的过渡。

另请参阅 自定义 StackView。

此属性用于保存将项目推入堆栈时应用于项目进入堆栈的过渡。

另请参阅 自定义 StackView。

该属性用于保存当另一个项目被推入堆栈时应用于退出堆栈的项目的过渡。

另请参阅 自定义 StackView。

此属性保存当另一个项目被替换时应用于进入堆栈的项目的过渡。

另请参阅 自定义 StackView。

该属性用于保存当项目被其他项目替换时，应用于退出堆栈的项目的过渡。

另请参阅 自定义 StackView。

此附加属性保存所附加项目的堆栈索引，如果项目不在堆栈中，则保存-1 。

此附加属性保存所附加项目的堆栈状态，如果项目不在堆栈中，则保存StackView.Inactive 。

可用值：

该附加属性保存所附加项目的堆栈视图，如果项目不在堆栈中，则保存null 。

此附加属性表示所附加项目的可见性。其值与Item::visible 的值相同。

默认情况下，StackView 会在进入转换开始时显示进入的项目，并在退出转换结束时隐藏退出的项目。显式设置此属性可覆盖默认行为，从而使位于最顶部项目下方的项目保持可见。

StackView {
    id: stackView
    property real offset: 10
    width: 100; height: 100

    initialItem: Component {
        id: page
        Rectangle {
            property real pos: StackView.index * stackView.offset
            property real hue: Math.random()
            color: Qt.hsla(hue, 0.5, 0.8, 0.6)
            border.color: Qt.hsla(hue, 0.5, 0.5, 0.9)
            StackView.visible: true
        }
    }

    pushEnter: Transition {
        id: pushEnter
        ParallelAnimation {
            PropertyAction { property: "x"; value: pushEnter.ViewTransition.item.pos }
            NumberAnimation { properties: "y"; from: pushEnter.ViewTransition.item.pos + stackView.offset; to: pushEnter.ViewTransition.item.pos; duration: 400; easing.type: Easing.OutCubic }
            NumberAnimation { property: "opacity"; from: 0; to: 1; duration: 400; easing.type: Easing.OutCubic }
        }
    }
    popExit: Transition {
        id: popExit
        ParallelAnimation {
            PropertyAction { property: "x"; value: popExit.ViewTransition.item.pos }
            NumberAnimation { properties: "y"; from: popExit.ViewTransition.item.pos; to: popExit.ViewTransition.item.pos + stackView.offset; duration: 400; easing.type: Easing.OutCubic }
            NumberAnimation { property: "opacity"; from: 1; to: 0; duration: 400; easing.type: Easing.OutCubic }
        }
    }

    pushExit: Transition {
        id: pushExit
        PropertyAction { property: "x"; value: pushExit.ViewTransition.item.pos }
        PropertyAction { property: "y"; value: pushExit.ViewTransition.item.pos }
    }
    popEnter: Transition {
        id: popEnter
        PropertyAction { property: "x"; value: popEnter.ViewTransition.item.pos }
        PropertyAction { property: "y"; value: popEnter.ViewTransition.item.pos }
    }
}

该属性在 QtQuick.Controls 2.2 (Qt 5.9) 中引入。

当所连接的项目在堆栈中被激活时，就会发出该连接信号。

此信号在 QtQuick.Controls 2.1 (Qt 5.8) 中引入。

另请参阅 status 。

当所连接的项目正在堆栈中被激活时，就会发出该连接信号。

该信号在 QtQuick.Controls 2.1 (Qt 5.8) 中引入。

另请参阅 status 。

当所连接的项目在堆栈中停用时，就会发出该连接信号。

该信号在 QtQuick.Controls 2.1 (Qt 5.8) 中引入。

另请参阅 status 。

当所连接的项目在堆栈中被停用时，就会发出该连接信号。

该信号在 QtQuick.Controls 2.1 (Qt 5.8) 中引入。

另请参阅 status 。

当所连接的项目从堆栈中移除时，就会发出该连接信号。例如，它可用于安全销毁推入堆栈的项目：

Item {
    StackView.onRemoved: destroy() // Will be destroyed sometime after this call.
}

该信号在 QtQuick.Controls 2.1 (Qt 5.8) 中引入。

另请参阅 status 。

删除堆栈中的所有项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参见Item Ownership 。

自QtQuick.Controls 2.3 起，可选择指定transition 。支持转换：

搜索堆栈中的特定项目。堆栈中的每个项目（以项目和索引为参数）都会调用callback 函数，直到回调函数返回true 。返回值就是找到的项目。例如

stackView.find(function(item, index) {
    return item.isTheOne
})

支持的behavior 值：

返回堆栈中index 位置的项目，如果索引超出范围，则返回null 。

支持的behavior 值：

从堆栈中取出一个或多个项目。返回从堆栈中移除的最后一个项目。

如果指定了item 参数，则将弹出直到（但不包括）item 的所有项目。如果item 是null ，则会弹出下至第一个项目（但不包括第一个项目）的所有项目。如果未指定，则只弹出当前项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参见Item Ownership 。

可以选择指定operation 作为最后一个参数。支持的操作：

如果没有提供任何操作，则将使用PopTransition 。

示例

stackView.pop()
stackView.pop(someItem, StackView.Immediate)
stackView.pop(StackView.Immediate)
stackView.pop(null)

另请参阅 clear(),Popping Items, 和Unwinding Items via Pop 。

从堆栈中取出currentItem 。返回从堆栈中移除的最后一个项目，如果depth 是1 ，则返回null 。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可指定为operation 。支持的操作：

如果没有提供任何操作，将使用PopTransition 。

此函数等同于popToIndex(stackView.currentIndex - 1) 。

此方法在 Qt 6.7 中引入。

另请参阅 clear(),Popping Items, 和Unwinding Items via Pop 。

将所有项目下拉至（但不包括）index 。返回从堆栈中移除的最后一个项目。

如果index 越界，则会发出警告并返回null 。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参见Item Ownership 。

最后一个参数可指定为operation 。支持的操作：

如果没有提供任何操作，将使用PopTransition 。

stackView.popToIndex(stackView.depth - 2, StackView.Immediate)

此方法在 Qt 6.7 中引入。

另请参阅 clear(),Popping Items, 和Unwinding Items via Pop 。

将所有项目下拉至（但不包括）item 。返回从堆栈中删除的最后一个项目。

如果item 是null ，则会产生警告并返回null 。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可选择指定为operation 。支持的操作：

如果没有提供任何操作，将使用PopTransition 。

stackView.popToItem(someItem, StackView.Immediate)

此方法在 Qt 6.7 中引入。

另请参阅 clear(),Popping Items, 和Unwinding Items via Pop 。

使用可选的operation 将item 推入堆栈，并可选地在该项目上应用一组properties 。项目可以是Item 、Component 或url 。返回当前项目。

StackView 如果推送的项目是 或 ，则会自动创建一个实例，该实例会在从堆栈中弹出时被销毁。更多信息请参阅 。Component url Item Ownership

可选的properties 参数指定了推送项的初始属性值映射。对于动态创建的项目，这些值会在创建最终完成前应用。这比在创建后设置属性值更有效率，尤其是在定义了大量属性值集的情况下，而且还允许在创建项目前设置属性绑定（使用Qt.binding() ）。

推送单个项目：

stackView.push(rect)

// or with properties:
stackView.push(rect, {"color": "red"})

通过将多个项目作为附加参数或数组传递，可以同时推送多个项目。最后一个项目将成为当前项目。每个项目后面都可以有一组要应用的属性。

传递可变数量的参数：

stackView.push(rect1, rect2, rect3)

// or with properties:
stackView.push(rect1, {"color": "red"}, rect2, {"color": "green"}, rect3, {"color": "blue"})

推送一个项目数组：

stackView.push([rect1, rect2, rect3])

// or with properties:
stackView.push([rect1, {"color": "red"}, rect2, {"color": "green"}, rect3, {"color": "blue"}])

可选择将operation 指定为最后一个参数。支持的操作

如果没有提供任何操作，则在堆栈为空时使用Immediate ，否则使用PushTransition 。

另请参阅 initialItem 和Pushing Items 。

将item 推入堆栈，可选择应用一组properties ，使用可选的operation 。返回当前项目（最后一个项目）。

最后一个参数可指定为operation 。支持的操作

如果没有提供任何操作，将使用PushTransition 。

要将多个项目推入堆栈，请使用pushItems() 。

此方法在 Qt 6.7 中引入。

另请参阅 initialItem 和Pushing Items 。

该函数重载 pushItem()。

将component 推入堆栈，可选择应用一组properties ，使用可选的operation 。返回当前项目（最后一个项目）。

可选择将operation 指定为最后一个参数。支持的操作

如果没有提供任何操作，将使用PushTransition 。

要将多个项目推入堆栈，请使用pushItems() 。

此方法在 Qt 6.7 中引入。

另请参阅 initialItem 和Pushing Items 。

该函数重载 pushItem()。

将url 推入堆栈，可选择应用一组properties ，使用可选的operation 。返回当前项目（最后一个项目）。

可选择将operation 指定为最后一个参数。支持的操作

如果没有提供任何操作，将使用PushTransition 。

要将多个项目推入堆栈，请使用pushItems() 。

此方法在 Qt 6.7 中引入。

另请参阅 initialItem 和Pushing Items 。

使用可选的operation 将items 推入堆栈，并对每个元素应用一组属性。items 是一个元素数组。每个元素可以是Item 、Component 或url ，后面还可以跟一个可选的属性参数（见下文）。返回当前项目（最后一个项目）。

StackView 如果推送的元素是 或 ，则会自动创建一个实例，该实例会在从堆栈中弹出时被销毁。更多信息请参见 。Component url Item Ownership

可选属性参数位于每个项目之后，指定了初始属性值的映射。对于动态创建的项目，这些值会在创建完成前应用。这比在创建后设置属性值更有效率，尤其是在定义了大量属性值的情况下，而且还允许在创建项目前设置属性绑定（使用Qt.binding() ）。

stackView.push([item, rectComponent, Qt.resolvedUrl("MyItem.qml")])

// With properties:
stackView.pushItems([
    item, { "color": "red" },
    rectComponent, { "color": "green" },
    Qt.resolvedUrl("MyItem.qml"), { "color": "blue" }
])

// With properties for only some items:
stackView.pushItems([
    item, { "color": "yellow" },
    rectComponent
])

可以选择将operation 指定为最后一个参数。支持的操作

如果没有提供任何操作，将使用PushTransition 。

要推送单个项目，请使用相关的pushItem 函数：

• pushItem(项目、属性、操作）
• pushItem(组件，属性，操作）
• pushItem(url,属性,操作)

此方法在 Qt 6.7 中引入。

另请参阅 initialItem,pushItem, 和Pushing Items 。

用指定的item 和可选的operation 替换堆栈中的一个或多个项目，并可选地在项目上应用一组properties 。项目可以是Item 、Component 或url 。返回成为当前项目的项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

如果指定了target 参数，则会替换从target 开始的所有项目。如果target 是null ，堆栈中的所有项目都将被替换。如果未指定，则只会替换最上面的项目。

StackView 如果替换项是 ，或 ，系统将自动创建一个实例。可选的 参数指定了替换项的初始属性值映射。对于动态创建的项，这些值会在创建完成前应用。这比在创建后设置属性值更有效，尤其是在定义了大量属性值的情况下，而且还允许在创建项目前设置属性绑定（使用 ()) 。Component url properties Qt.binding

替换顶层项目：

stackView.replace(rect)

// or with properties:
stackView.replace(rect, {"color": "red"})

通过将多个项目作为附加参数或数组传递，可以同时替换多个项目。每个项目后面都可以跟一组要应用的属性。

传递可变数量的参数：

stackView.replace(rect1, rect2, rect3)

// or with properties:
stackView.replace(rect1, {"color": "red"}, rect2, {"color": "green"}, rect3, {"color": "blue"})

替换项目数组：

stackView.replace([rect1, rect2, rect3])

// or with properties:
stackView.replace([rect1, {"color": "red"}, rect2, {"color": "green"}, rect3, {"color": "blue"}])

可选择将operation 指定为最后一个参数。支持的操作

如果没有提供任何操作，则在堆栈为空时使用Immediate ，否则使用ReplaceTransition 。

下面的示例说明了如何使用 replace() 进行 push 和 pop 过渡。

StackView {
    id: stackView

    initialItem: Component {
        id: page

        Page {
            Row {
                spacing: 20
                anchors.centerIn: parent

                Button {
                    text: "<"
                    onClicked: stackView.replace(page, StackView.PopTransition)
                }
                Button {
                    text: ">"
                    onClicked: stackView.replace(page, StackView.PushTransition)
                }
            }
        }
    }
}

另请参阅 push() 和Replacing Items 。

从堆栈中取出currentItem ，并推入items 。如果指定了可选的operation ，则将使用相关的转换。每个项目后都可以跟一组应用于该项的可选属性。返回当前的项目。

可选属性参数位于每个项目之后，指定了初始属性值的映射。对于动态创建的项目，这些值会在创建完成前应用。这比在创建后设置属性值更有效，尤其是在定义了大量属性值的情况下，而且还允许在创建项目前设置属性绑定（使用Qt.binding()) 。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可选择指定operation 。支持的操作：

如果没有提供任何操作，将使用ReplaceTransition 。

stackView.replaceCurrentItem([item, rectComponent, Qt.resolvedUrl("MyItem.qml")])

// With properties:
stackView.replaceCurrentItem([
    item, { "color": "red" },
    rectComponent, { "color": "green" },
    Qt.resolvedUrl("MyItem.qml"), { "color": "blue" }
])

要推送单个项目，请使用相关的重载：

• replaceCurrentItem(项目, 属性, 操作）
• replaceCurrentItem(组件, 属性, 操作）
• replaceCurrentItem(url,属性,操作)

此方法在 Qt 6.7 中引入。

另请参阅 push() 和Replacing Items 。

该函数重载 replaceCurrentItem()。

将currentItem 从堆栈中取出，并推入item 。如果指定了可选的operation ，则将使用相关的转换。如果指定了可选的properties ，它们将应用于项目。返回成为当前项目的项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可选择指定operation 。支持的操作：

如果没有提供操作，将使用ReplaceTransition 。

要将多个项目推入堆栈，请使用replaceCurrentItem(items, operation)。

此方法在 Qt 6.7 中引入。

另请参阅 Replacing Items 。

该函数重载 replaceCurrentItem()。

从堆栈中取出currentItem ，并推入component 。如果指定了可选的operation ，则将使用相关的转换。如果指定了可选的properties ，它们将应用于项目。返回成为当前项目的项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可选择指定operation 。支持的操作：

如果没有提供操作，将使用ReplaceTransition 。

要将多个项目推入堆栈，请使用replaceCurrentItem(items, operation)。

此方法在 Qt 6.7 中引入。

另请参阅 Replacing Items 。

该函数重载 replaceCurrentItem()。

从堆栈中取出currentItem ，并推入url 。如果指定了可选的operation ，则将使用相关的转换。如果指定了可选的properties ，它们将应用于项目。返回成为当前项目的项目。

只有StackView 自己创建的项目（来自Component 或url ）才会在弹出时被销毁。更多信息请参阅Item Ownership 。

最后一个参数可选择指定operation 。支持的操作：

如果没有提供操作，将使用ReplaceTransition 。

要将多个项目推入堆栈，请使用replaceCurrentItem(items, operation)。

此方法在 Qt 6.7 中引入。

另请参阅 Replacing Items 。