PageIndicator QML Type
現在アクティブなページを示します。詳細...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
プロパティ
- count : int
- currentIndex : int
- delegate : Component
- interactive : bool
詳細説明
PageIndicator は、複数のページを含むコンテナ内で、現在アクティブなページを示すために使用されます。PageIndicator は、ページを表示するデリゲート項目で構成されています。
Column {
StackLayout {
id: stackLayout
Page {
// ...
}
Page {
// ...
}
Page {
// ...
}
}
PageIndicator {
currentIndex: stackLayout.currentIndex
count: stackLayout.count
}
}「 SwipeView 」、「PageIndicatorのカスタマイズ」、および「インジケーター コントロール」も参照してください 。
プロパティのドキュメント
count : int
このプロパティはページ数を保持します。
currentIndex : int
このプロパティには、現在のページのインデックスが格納されます。
delegate : Component
このプロパティには、ページを表示するデリゲートが格納されています。
各デリゲートのコンテキストでは、以下のプロパティが利用可能です：
| index: int | 項目のインデックス |
| pressed: bool | アイテムが押されているかどうか |
PageIndicator デリゲートの所有権を取得しません。
interactive : bool
このプロパティは、コントロールがインタラクティブであるかどうかを表します。インタラクティブなページインジケーターは、クリックに反応し、current index を自動的に適切に変更します。
SwipeView {
id: view
currentIndex: pageIndicator.currentIndex
anchors.fill: parent
Page {
title: qsTr("Home")
}
Page {
title: qsTr("Discover")
}
Page {
title: qsTr("Activity")
}
}
PageIndicator {
id: pageIndicator
interactive: true
count: view.count
currentIndex: view.currentIndex
anchors.bottom: parent.bottom
anchors.horizontalCenter: parent.horizontalCenter
}注：ページインジケーターは 通常、ユーザーインターフェースの実際のコンテンツからユーザーの注意をそらさないようにするため、非常に小さく設計されています。クリックしづらい場合があり、ユーザーからインタラクティブな要素として認識されにくい可能性があります。これらの理由から、ページインジケーターは主要なナビゲーション方法（SwipeView など）を補完するために使用するのが最適であり、それらに取って代わるものではありません。
デフォルト値は `false` です。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
