En esta página

Page QML Type

Control de página estilizado con soporte para cabecera y pie de página. Más...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propiedades

Descripción detallada

Page es un control contenedor que permite añadir un elemento header y footer a una página.

Diseño de página con cabecera, área de contenido y pie de página

Los elementos declarados como hijos de una Página son

  • automáticamente vinculados al elemento de contenido de la página. Los elementos creados dinámicamente deben estar vinculados explícitamente al elemento de contenido.
  • no se posicionan ni redimensionan automáticamente.

El siguiente fragmento de ejemplo ilustra cómo utilizar una cabecera de barra de herramientas específica de la página y un pie de barra de pestañas para toda la aplicación.

import QtQuick.Controls
import QtQuick.Layouts

ApplicationWindow {
    visible: true

    StackView {
        anchors.fill: parent

        initialItem: Page {
            header: ToolBar {
                // ...
            }

            ColumnLayout {
                anchors.fill: parent
                // ...
            }
        }
    }

    footer: TabBar {
        // ...
    }
}

Consulte también ApplicationWindow, Controles de contenedor y Gestión del enfoque en Qt Quick Controls.

Documentación de propiedades

Esta propiedad contiene el elemento de pie de página. El elemento de pie de página se posiciona en la parte inferior y se redimensiona al ancho de la página. El valor por defecto es null.

Nota: La asignación de un elemento ToolBar, TabBar, o DialogButtonBox como pie de página establece automáticamente la respectiva propiedad ToolBar::position, TabBar::position, o DialogButtonBox::position a Footer.

Véase también header y ApplicationWindow::footer.

header : Item

Esta propiedad contiene el elemento de cabecera de la página. El elemento de cabecera se posiciona en la parte superior y se redimensiona al ancho de la página. El valor por defecto es null.

Nota: La asignación de un elemento ToolBar, TabBar, o DialogButtonBox como encabezado de página establece automáticamente la respectiva propiedad ToolBar::position, TabBar::position, o DialogButtonBox::position a Header.

Véase también footer y ApplicationWindow::header.

implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la altura implícita del pie de página.

El valor es igual a footer && footer.visible ? footer.implicitHeight : 0.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitFooterWidth y implicitHeaderHeight.

implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene el ancho implícito del pie de página.

El valor es igual a footer && footer.visible ? footer.implicitWidth : 0.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitFooterHeight y implicitHeaderWidth.

implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la altura implícita de la cabecera.

El valor es igual a header && header.visible ? header.implicitHeight : 0.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitHeaderWidth y implicitFooterHeight.

implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene el ancho implícito de la cabecera.

El valor es igual a header && header.visible ? header.implicitWidth : 0.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitHeaderHeight y implicitFooterWidth.

title : string

Esta propiedad contiene el título de la página.

El título se muestra a menudo en la parte superior de una página para dar al usuario contexto sobre la página que está viendo.

La página no muestra el título por sí misma, sino que depende de la aplicación para hacerlo. Por ejemplo:

ApplicationWindow {
    visible: true
    width: 400
    height: 400

    header: Label {
        text: view.currentItem.title
        horizontalAlignment: Text.AlignHCenter
    }

    SwipeView {
        id: view
        anchors.fill: parent

        Page {
            title: qsTr("Home")
        }
        Page {
            title: qsTr("Discover")
        }
        Page {
            title: qsTr("Activity")
        }
    }
}

© 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.