En esta página

Page QML Type

Control de página con estilo que admite encabezado y pie de página. Más...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propiedades

Descripción detallada

«Page» es un control contenedor que facilita la incorporación de elementos de tipo « header » y « footer » a una página.

Diseño de página en el que se muestran el encabezado, el área de contenido y el pie de página

Los elementos declarados como hijos de una «Page» quedan:

  • se asocian automáticamente al contentItem de la «Page». Los elementos creados dinámicamente deben asociarse explícitamente al contentItem.
  • No se posicionan ni se redimensionan automáticamente.

El siguiente fragmento de código ilustra cómo utilizar un encabezado de barra de herramientas específico de la página y un pie de página 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 {
        // ...
    }
}

Véase también « ApplicationWindow» , «Controles de contenedor» y «Gestión del foco» en la documentación de los controles de Qt Quick .

Documentación de propiedades

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

Nota: Al asignar un valor de « ToolBar », « TabBar » o « DialogButtonBox » como pie de página, se establece automáticamente la propiedad correspondiente « ToolBar::position », « TabBar::position » o « DialogButtonBox::position » en « 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 coloca en la parte superior y se ajusta al ancho de la página. El valor por defecto es null.

Nota: Al asignar un « ToolBar », « TabBar » o « DialogButtonBox » como encabezado de página, se establece automáticamente la propiedad correspondiente « ToolBar::position », « TabBar::position » o « DialogButtonBox::position » en « 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 almacena 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 del encabezado.

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 del encabezado.

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 suele aparecer en la parte superior de la página para proporcionar al usuario información sobre el contexto de la página que está viendo.

Page no muestra el título por sí misma, sino que deja que sea la aplicación la que se encargue de ello. 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.