StackView QML 类型

此属性表示是否有一个转换正在进行。

此属性表示栈中最上层的项。

此属性表示当前已推入栈中的项数量。

此属性表示栈是否为空。

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

另请参阅depth。

此属性表示在 StackView 创建时应显示的初始项。初始项可以是 Item，组件 或 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）在弹出时被销毁。有关更多信息，请参阅 项所有者。

从 QtQuick.Controls 2.3 版本开始，可以可选地指定 过渡。支持的过渡包括：

在栈内搜索特定项目。对于栈中的每个项目，都会调用 回调 函数（带有项目及其索引作为参数），直到回调函数返回 true。返回值是找到的项目。例如

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

支持的 行为 值

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

支持的 行为 值

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

如果指定了 项目 参数，则将移除从该项目（但不包括该项目） downward 的所有项目。如果 项目 是 null，则移除到（但不包括）第一个项目。如果没有指定，则只移除当前项目。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

示例

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

另请参阅：clear()、移除项目 和 通过 pop 还原项目。

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

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

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

此方法是在 Qt 6.7 版本中引入的。

另请参阅：clear()、移除项目 和 通过 pop 还原项目。

将所有项目弹出到（但不包括）索引。返回从栈中移除的最后一个项目。

如果 索引 超出范围，将产生警告并返回 null。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

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

此方法是在 Qt 6.7 版本中引入的。

另请参阅：clear()、移除项目 和 通过 pop 还原项目。

将所有项目弹出到（但不包括）item。返回从栈中移除的最后一个项目。

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

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

stackView.popToItem(someItem, StackView.Immediate)

此方法是在 Qt 6.7 版本中引入的。

另请参阅：clear()、移除项目 和 通过 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"}])

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果没有提供操作，如果栈为空，则使用 Immediate，否则使用 PushTransition。

也请参阅：initialItem 和 Pushing Items。

将 item 推送到栈上，可选地应用一组 properties，使用可选的 operation。返回成为当前的项目（最后一个项目）。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果没有提供操作，则使用 PushTransition。

要推送多个项目到栈上，请使用 pushItems 方法。

此方法是在 Qt 6.7 版本中引入的。

也请参阅：initialItem 和 Pushing Items。

此函数覆盖了 pushItem()。

将 component 推送到栈上，可选地应用一组 properties，使用可选的 operation。返回成为当前的项目（最后一个项目）。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果没有提供操作，则使用 PushTransition。

要推送多个项目到栈上，请使用 pushItems 方法。

此方法是在 Qt 6.7 版本中引入的。

也请参阅：initialItem 和 Pushing Items。

此函数覆盖了 pushItem()。

将 url 推送到栈上，可选地应用一组 properties，使用可选的 operation。返回成为当前的项目（最后一个项目）。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果没有提供操作，则使用 PushTransition。

要推送多个项目到栈上，请使用 pushItems 方法。

此方法是在 Qt 6.7 版本中引入的。

也请参阅：initialItem 和 Pushing Items。

使用可选的操作将项目压入栈中，并可选地对每个元素应用一组属性。 项目是一组元素。每个元素可以是Item、组件或url，之后可以跟一个可选的属性参数（见下文）。返回成为当前的项目（最后一个项目）。

StackView会自动创建实例，如果压入的元素是组件或url，并且实例在从栈中移除时会销毁。有关更多信息，请参阅项目所有权。

可选属性参数紧跟在每个项目之后，并指定初始属性值的映射。对于动态创建的项目，这些值在创建最终确定之前应用。这比创建后设置属性值更有效，特别是在定义大量属性值的情况下，并且还可以在项目创建之前设置属性绑定（使用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
])

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果没有提供操作，则使用 PushTransition。

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

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

此方法是在 Qt 6.7 版本中引入的。

另请参阅 initialItem、pushItem和Pushing Items。

使用指定的项目和可选的操作替换栈中的一个或多个项目，并可选地对项目应用一组属性。项目可以是Item、组件或url。返回成为当前的项目。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

如果指定了目标参数，则会将所有直到目标项目的项目替换。如果目标是null，则替换栈中的所有项目。如果要替换的项目未指定，则仅替换最顶部的项目。

StackView会自动创建实例，如果替换的项目是组件或url。可选的属性参数指定用于替换项的初始属性值的映射。对于动态创建的项目，这些值在创建最终确定之前应用。这比创建后设置属性值更有效，特别是在定义大量属性值的情况下，并且还可以在项目创建之前设置属性绑定（使用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"}])

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

以下示例说明了使用replace()与推入和弹出过渡一起使用的方法。

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() 和 替换项目。

从堆栈中弹出 currentItem 并推送 items。如果指定了可选的 operation，将使用相关的过渡效果。每个项目可以后面跟一个可选项的属性集，这些属性将应用于该项目。返回成为当前的项目。

可选属性参数紧跟在每个项目之后，并指定初始属性值的映射。对于动态创建的项目，这些值在创建最终确定之前应用。这比创建后设置属性值更有效，特别是在定义大量属性值的情况下，并且还可以在项目创建之前设置属性绑定（使用Qt.binding()）。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

如果未提供操作，将使用 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(item, properties, operation)
• replaceCurrentItem(component, properties, operation)
• replaceCurrentItem(url, properties, operation)

此方法是在 Qt 6.7 版本中引入的。

另请参阅push() 和 替换项目。

此函数是 replaceCurrentItem() 的重载。

从堆栈中弹出 currentItem 并推送 item。如果指定了可选的 operation，将使用相关的过渡效果。如果指定了可选的 properties，它们将应用于项目。返回成为当前的项目。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

要向堆栈中推送多个项目，请使用 replaceCurrentItem(items, operation)。

此方法是在 Qt 6.7 版本中引入的。

另请参阅替换项目。

此函数是 replaceCurrentItem() 的重载。

从堆栈中弹出 currentItem 并推送 component。如果指定了可选的 operation，将使用相关的过渡效果。如果指定了可选的 properties，它们将应用于项目。返回成为当前的项目。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

要向堆栈中推送多个项目，请使用 replaceCurrentItem(items, operation)。

此方法是在 Qt 6.7 版本中引入的。

另请参阅替换项目。

此函数是 replaceCurrentItem() 的重载。

从堆栈中弹出 currentItem 并推送 url。如果指定了可选的 operation，将使用相关的过渡效果。如果指定了可选的 properties，它们将应用于项目。返回成为当前的项目。

只会有 StackView 自己创建的项（从一个 Component 或 URL）在弹出时被销毁。有关更多信息，请参阅 项所有者。

可以可选地指定最后一个参数作为 操作。支持的操作包括：

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

要向堆栈中推送多个项目，请使用 replaceCurrentItem(items, operation)。

此方法是在 Qt 6.7 版本中引入的。

另请参阅替换项目。