ApplicationWindow QML Type

Ventana estilizada de nivel superior con soporte para cabecera y pie de página. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• activeFocusControl : Control
• background : Item
• bottomPadding : real (since 6.9)
• contentData : list<QtObject>
• contentItem : Item
• font : font
• footer : Item
• header : Item
• leftPadding : real (since 6.9)
• locale : Locale
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• rightPadding : real (since 6.9)
• topPadding : real (since 6.9)

Propiedades anexas

• activeFocusControl : Control
• contentItem : Item
• footer : Item
• header : Item
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• window : ApplicationWindow

Descripción detallada

ApplicationWindow es un Window que permite añadir un elemento menu bar, header y footer a la ventana.

Puede declarar ApplicationWindow como el elemento raíz de su aplicación, y ejecutarlo utilizando QQmlApplicationEngine. De esta forma puedes controlar las propiedades, apariencia y diseño de la ventana desde QML.

import QtQuick.Controls

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

Propiedades adjuntas de ApplicationWindow

Debido a cómo funciona la resolución de ámbito y nombres en QML, es posible hacer referencia a id del elemento raíz de la aplicación en cualquier parte de sus objetos QML hijos. Aunque este enfoque está bien para muchas aplicaciones y casos de uso, para un componente QML genérico puede no ser aceptable, ya que crea una dependencia con el entorno circundante.

ApplicationWindow proporciona un conjunto de propiedades adjuntas que pueden utilizarse para acceder a la ventana y a sus bloques de construcción desde lugares en los que no se dispone de acceso directo a la ventana, sin crear una dependencia con una ventana determinada id. Un componente QML que utilice las propiedades adjuntas de ApplicationWindow funciona en cualquier ventana, independientemente de su dirección id.

Áreas seguras

Desde Qt 6.9 ApplicationWindow añadirá automáticamente relleno a contentItem para cualquier safe area margins informado por la ventana. Esto asegura que el contentItem permanece dentro del área segura de la ventana, mientras que el elemento de fondo cubre toda la ventana.

Si maneja manualmente los márgenes del área segura en el contentItem de la ventana, puede anular el valor predeterminado mediante las propiedades topPadding, leftPadding, rightPadding y bottomPadding:

ApplicationWindow {
    // Remove automatic safe area padding
    topPadding: 0

    Flickable {
        // Inset content by safe area margin
        topMargin: SafeArea.margins.top
    }
}

Las propiedades header, footer, y menuBar no reciben ningún relleno automático para los márgenes de área segura. Sin embargo, dependiendo del estilo en uso, el estilo puede tener en cuenta las áreas seguras en su implementación de ToolBar, TabBar, y MenuBar.

Véase también Personalización de ApplicationWindow, Overlay, Page, Controles de contenedor y Gestión de foco en Qt Quick Controls.

Documentación de propiedades

activeFocusControl : Control [read-only]

Esta propiedad contiene el control que tiene actualmente el foco activo, o null si no hay ningún control con foco activo.

La diferencia entre Window::activeFocusItem y ApplicationWindow::activeFocusControl es que el primero puede apuntar a un elemento de un control, mientras que el segundo apunta al control que lo rodea. Por ejemplo, cuando SpinBox tiene el foco, activeFocusItem apunta al editor y activeFocusControl al propio SpinBox.

Véase también Window::activeFocusItem.

background : Item

Esta propiedad contiene el elemento de fondo.

El elemento de fondo se apila debajo de content item, pero por encima de background color de la ventana.

El elemento de fondo es útil para imágenes y degradados, por ejemplo, pero la propiedad color es preferible para colores sólidos, ya que no necesita crear un elemento.

Véase también Personalización de ApplicationWindow, contentItem, header, y footer.

bottomPadding : real [since 6.9]

Esta propiedad contiene el relleno inferior del elemento de contenido de la ventana. A menos que se establezca explícitamente, el valor refleja el de la ventana safe area margins.

Esta propiedad se introdujo en Qt 6.9.

Véase también topPadding, leftPadding, y rightPadding.

contentData : list<QtObject> [default]

Esta propiedad por defecto contiene la lista de todos los objetos declarados como hijos de la ventana.

La propiedad data permite mezclar libremente hijos visuales, recursos y otras ventanas en un ApplicationWindow.

Si asigna un elemento a la lista contentData, se convertirá en hijo de la ventana contentItem, de modo que aparecerá dentro de la ventana. El padre del elemento será la ventana contentItem.

Por lo general, no debería ser necesario hacer referencia a la propiedad contentData, ya que es la propiedad por defecto de ApplicationWindow y, por tanto, todos los elementos hijos se asignan automáticamente a esta propiedad.

Véase también contentItem.

contentItem : Item [read-only]

Esta propiedad contiene el elemento de contenido de la ventana.

El elemento de contenido se apila encima del elemento background, y debajo de los elementos menuBar, header, y footer.

Desde Qt 6.9 ApplicationWindow añadirá automáticamente relleno al elemento de contenido para cualquier safe area margins informado por la ventana. Para anular el relleno usa las propiedades de relleno individuales.

Ver también background, menuBar, header, footer, topPadding, bottomPadding, leftPadding, y rightPadding.

font : font

Esta propiedad contiene la fuente actualmente establecida para la ventana.

La fuente por defecto depende del entorno del sistema. QGuiApplication mantiene una fuente de sistema/tema que sirve como fuente por defecto para todas las ventanas de la aplicación. También puede establecer la fuente predeterminada para las ventanas pasando una fuente personalizada a QGuiApplication::setFont(), antes de cargar cualquier QML. Finalmente, la fuente se compara con la base de datos de fuentes de Qt para encontrar la más adecuada.

ApplicationWindow propaga las propiedades explícitas de la fuente a los controles hijos. Si cambia una propiedad específica en la fuente de la ventana, esa propiedad se propaga a todos los controles hijos de la ventana, anulando cualquier valor predeterminado del sistema para esa propiedad.

Véase también Control::font.

footer : Item

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

ApplicationWindow {
    footer: ToolBar {
        // ...
    }
}

Véase también menuBar, header, y Page::footer.

header : Item

Esta propiedad contiene el elemento de cabecera de la ventana. El elemento de cabecera se coloca en la parte superior de la ventana, debajo de la barra de menús, y se redimensiona al ancho de la ventana. El valor por defecto es null.

ApplicationWindow {
    header: TabBar {
        // ...
    }
}

Véase también menuBar, footer, y Page::header.

leftPadding : real [since 6.9]

Esta propiedad contiene el relleno izquierdo del elemento de contenido de la ventana. A menos que se establezca explícitamente, el valor refleja el de la ventana safe area margins.

Esta propiedad se introdujo en Qt 6.9.

Véase también bottomPadding, topPadding, y rightPadding.

locale : Locale

Esta propiedad contiene la configuración regional de la ventana.

La configuración regional por defecto depende del entorno del sistema. Puede establecer la configuración regional por defecto llamando a QLocale::setDefault(), antes de cargar cualquier QML.

ApplicationWindow propaga la configuración regional a los controles hijos. Si cambia la configuración regional de la ventana, ésta se propaga a todos los controles hijos de la ventana, anulando la configuración regional por defecto del sistema.

Véase también Control::locale.

menuBar : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad contiene la barra de menú de la ventana. La barra de menú se sitúa en la parte superior de la ventana, por encima de la cabecera, y se redimensiona al ancho de la ventana. El valor por defecto es null.

ApplicationWindow {
    menuBar: MenuBar {
        // ...
    }
}

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Véase también header, footer, y MenuBar.

rightPadding : real [since 6.9]

Esta propiedad contiene el relleno derecho del elemento de contenido de la ventana. A menos que se establezca explícitamente, el valor refleja el de la ventana safe area margins.

Esta propiedad se introdujo en Qt 6.9.

Véase también bottomPadding, leftPadding, y topPadding.

topPadding : real [since 6.9]

Esta propiedad contiene el relleno superior del elemento de contenido de la ventana. A menos que se establezca explícitamente, el valor refleja el de la ventana safe area margins.

Esta propiedad se introdujo en Qt 6.9.

Véase también bottomPadding, leftPadding, y rightPadding.

Documentación de la propiedad Attached

ApplicationWindow.activeFocusControl : Control [read-only]

Esta propiedad adjunta contiene el control que actualmente tiene el foco activo, o null si no hay ningún control con foco activo. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en una ventana, o la ventana no tiene foco activo.

Véase también Window::activeFocusItem y Attached ApplicationWindow Properties.

ApplicationWindow.contentItem : Item [read-only]

Esta propiedad adjunta contiene el elemento de contenido de la ventana. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en un ApplicationWindow.

Véase también Attached ApplicationWindow Properties.

ApplicationWindow.footer : Item [read-only]

Esta propiedad adjunta contiene el elemento del pie de la ventana. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en un ApplicationWindow, o la ventana no tiene elemento de pie de página.

Véase también Attached ApplicationWindow Properties.

ApplicationWindow.header : Item [read-only]

Esta propiedad adjunta contiene el elemento de cabecera de la ventana. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en un ApplicationWindow, o la ventana no tiene elemento de cabecera.

Véase también Attached ApplicationWindow Properties.

ApplicationWindow.menuBar : Item [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad adjunta contiene la barra de menú de la ventana. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en ApplicationWindow, o la ventana no tiene barra de menú.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Véase también Attached ApplicationWindow Properties.

ApplicationWindow.window : ApplicationWindow [read-only]

Esta propiedad adjunta contiene la ventana de la aplicación. La propiedad puede adjuntarse a cualquier elemento. El valor es null si el elemento no está en un ApplicationWindow.

Véase también Attached ApplicationWindow Properties.