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のカスタマイズも参照して ください。

この Attached プロパティは、アタッチされているアイテムのスタックインデックスを保持し、アイテムがスタックにない場合は、-1 。

この Attached プロパティは、アタッチされているアイテムのスタックステータスを保持し、アイテムがスタックにない場合は、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も参照してください 。

スタックからすべてのアイテムを削除します。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくはItem Ownership を参照してください。

QtQuick.Controls 2.3 以降では、オプションでtransition を指定できます。サポートされるトランジション

スタック内の特定の項目を検索します。コールバック関数がtrue を返すまで、callback 関数がスタック内の各項目に対して（引数として項目とインデックスを指定して）呼び出されます。戻り値は見つかったアイテムです。例えば

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

サポートされるbehavior 値：

スタックの位置index にあるアイテム、またはインデックスが範囲外の場合はnull を返します。

サポートされるbehavior の値：

スタックから 1 つ以上の項目を取り出します。スタックから取り除かれた最後の項目を返す。

引数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 を返します。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくはItem Ownership を参照してください。

最後の引数にoperation を指定することもできる。サポートされる操作

操作が指定されていない場合は、PopTransition が使用される。

この関数はpopToIndex(stackView.currentIndex - 1) と同等です。

このメソッドは Qt 6.7 で導入されました。

clear()、Popping Items 、Unwinding Items via Popも参照してください 。

index までのすべての項目をポップダウンする。スタックから取り除かれた最後の項目を返す。

index が範囲外の場合、警告が出され、null が返される。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくは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 をスタックにプッシュし、オプションでoperation を使ってproperties のセットを適用する。カレントとなったアイテム（最後のアイテム）を返す。

最後の引数としてoperation をオプションで指定できる。サポートされる操作：

操作が指定されていない場合は、PushTransition 。

複数のアイテムをスタックにプッシュするには、pushItems() を使用します。

このメソッドはQt 6.7で導入されました。

initialItem とPushing Itemsも参照してください 。

この関数はpushItem()をオーバーロードする。

スタックにcomponent をプッシュし、オプションでoperation を使用してproperties のセットを適用する。カレントとなったアイテム（最後のアイテム）を返します。

最後の引数としてoperation をオプションで指定できる。サポートされる操作：

操作が指定されていない場合は、PushTransition 。

複数のアイテムをスタックにプッシュするには、pushItems() を使用します。

このメソッドはQt 6.7で導入されました。

initialItem とPushing Itemsも参照してください 。

この関数はpushItem()をオーバーロードする。

スタックにurl をプッシュし、オプションでoperation を使用してproperties のセットを適用する。カレントとなったアイテム（最後のアイテム）を返します。

最後の引数としてoperation をオプションで指定できる。サポートされる操作：

操作が指定されていない場合は、PushTransition 。

複数のアイテムをスタックにプッシュするには、pushItems() を使用します。

このメソッドはQt 6.7で導入されました。

initialItem とPushing Itemsも参照してください 。

オプシ ョ ンの引数operation を用いてitems をス タ ッ ク 上にプ ッ シュ し 、 オプシ ョ ンで各要素にプ ロパテ ィ 群を適用。items は要素の配列。各要素は、Item 、Component 、url のいずれかであり、その後にオプションのプロパティ引数（下記参照）を続けることができる。カレントとなったアイテム（最後のアイテム）を返します。

StackView プッシュされた要素が または の場合、自動的にインスタンスが作成され、スタックからポップ・オフされるとインスタンスは破棄されます。詳細は を参照してください。Component url Item Ownership

オプションの properties 引数は、各アイテムの後に続き、プロパティの初期値のマップを指定します。動的に作成されるアイテムの場合、これらの値は作成が確定する前に適用されます。これは、作成後にプロパティ値を設定するよりも効率的で、特に大きなプロパティ値のセットが定義されている場合、また、アイテムが作成される前にプロパティバインディングを（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, properties, operation)

このメソッドは Qt 6.7 で導入されました。

initialItem 、pushItem 、Pushing Itemsも参照してください 。

スタック上の 1 つ以上のアイテムを、指定されたitem とオプションのoperation で置き換え、オプションでアイテムにproperties のセットを適用します。アイテムは、Item 、Component 、またはurl のいずれかです。

Component またはurl から）StackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳細は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 （）を使用して）プロパティバインディングを設定することもできます。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくは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, properties, operation)

このメソッドは Qt 6.7 で導入されました。

push() およびReplacing Itemsも参照してください 。

この関数はreplaceCurrentItem()をオーバーロードする。

スタックからcurrentItem をポップし、item をプッシュする。オプションのoperation が指定された場合、関連するトランジションが使用されます。オプションのproperties が指定された場合、それらはアイテムに適用されます。カレントになったアイテムを返します。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくはItem Ownership を参照してください。

最後の引数にoperation を指定することもできる。サポートされている操作

操作が指定されていない場合は、ReplaceTransition 。

複数のアイテムをスタックにプッシュするには、replaceCurrentItem(items, operation)を使用します。

このメソッドは Qt 6.7 で導入されました。

Replacing Itemsも参照してください 。

この関数はreplaceCurrentItem()をオーバーロードする。

スタックからcurrentItem をポップし、component をプッシュする。オプションのoperation が指定された場合、関連するトランジションが使用されます。オプションのproperties が指定された場合、それらはアイテムに適用されます。カレントになったアイテムを返します。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくはItem Ownership を参照してください。

最後の引数にoperation を指定することもできる。サポートされている操作

操作が指定されていない場合は、ReplaceTransition 。

複数のアイテムをスタックにプッシュするには、replaceCurrentItem(items, operation)を使います。

このメソッドは Qt 6.7 で導入されました。

Replacing Itemsも参照してください 。

この関数はreplaceCurrentItem()をオーバーロードする。

スタックからcurrentItem をポップし、url をプッシュする。オプションのoperation が指定された場合、関連するトランジションが使用されます。オプションのproperties が指定された場合、それらはアイテムに適用されます。カレントになったアイテムを返します。

Component またはurl からStackView 自身が作成したアイテムだけが、ポップされたときに破棄されます。詳しくはItem Ownership を参照してください。

最後の引数にoperation を指定することもできる。サポートされている操作

操作が指定されていない場合は、ReplaceTransition 。

複数のアイテムをスタックにプッシュするには、replaceCurrentItem(items, operation)を使用します。

このメソッドは Qt 6.7 で導入されました。

Replacing Itemsも参照してください 。