En esta página

PageIndicator QML Type

Indica la página activa en ese momento. Más...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

Descripción detallada

PageIndicator se utiliza para indicar la página actualmente activa en un contenedor de múltiples páginas. PageIndicator consta de elementos delegados que presentan páginas.

Indicador de página que muestra la posición actual de la página

Column {
    StackLayout {
        id: stackLayout

        Page {
            // ...
        }
        Page {
            // ...
        }
        Page {
            // ...
        }
    }

    PageIndicator {
        currentIndex: stackLayout.currentIndex
        count: stackLayout.count
    }
}

Véase también SwipeView, Personalización de PageIndicator y Controles Indicadores.

Documentación de Propiedades

count : int

Esta propiedad contiene el número de páginas.

currentIndex : int

Esta propiedad contiene el índice de la página actual.

delegate : Component

Esta propiedad contiene un delegado que presenta una página.

Las siguientes propiedades están disponibles en el contexto de cada delegado:

index: intEl índice del elemento
pulsado: boolSi el elemento está pulsado

PageIndicator no es propiedad del delegado.

interactive : bool

Esta propiedad indica si el control es interactivo. Un indicador de página interactivo reacciona a las pulsaciones y cambia automáticamente el current index apropiadamente.

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
}

Nota: Los indicadores de página suelen ser bastante pequeños (para evitar distraer al usuario del contenido real de la interfaz de usuario). Pueden ser difíciles de pulsar, y puede que el usuario no los reconozca fácilmente como interactivos. Por estas razones, es mejor utilizarlos como complemento de los métodos primarios de navegación (como SwipeView), no para sustituirlos.

El valor por defecto es 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.