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.
