En esta página

PageIndicator QML Type

Indica la página activa en este 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 varias páginas. PageIndicator se compone de elementos delegados que presentan las 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 muestra una página.

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

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

PageIndicator no asume la 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 » según corresponda.

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 indicadoresde página suelen ser bastante pequeños (para evitar distraer al usuario del contenido real de la interfaz de usuario). Puede resultar difícil hacer clic en ellos y es posible que el usuario no los reconozca fácilmente como elementos interactivos. Por estas razones, es mejor utilizarlos para complementar los métodos principales de navegación (como SwipeView), y 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.