ApplicationWindow QML Type
Ventana de nivel superior con diseño personalizado y compatibilidad con encabezado y pie de página. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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 adjuntas
- 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 objeto de tipo « Window » que facilita la incorporación de elementos de tipo « menu bar », « header » y « footer » a la ventana.
Puedes declarar ApplicationWindow como el elemento raíz de tu aplicación y ejecutarlo mediante QQmlApplicationEngine. De esta forma, puedes controlar las propiedades, la apariencia y el diseño de la ventana desde QML.

import QtQuick.Controls
ApplicationWindow {
visible: true
menuBar: MenuBar {
// ...
}
header: ToolBar {
// ...
}
footer: TabBar {
// ...
}
StackView {
anchors.fill: parent
}
}Nota: Por defecto, una ApplicationWindow no es visible.
Propiedades asociadas a ApplicationWindow
Debido al funcionamiento del ámbito (Scope) y la resolución de nombres (Naming Resolution) en QML, es posible hacer referencia a ` id ` del elemento raíz de la aplicación desde cualquier lugar de sus objetos QML hijos. Aunque este enfoque es adecuado para muchas aplicaciones y casos de uso, puede que no sea aceptable para un componente QML genérico, ya que crea una dependencia del entorno circundante.
ApplicationWindow proporciona un conjunto de propiedades asociadas que pueden utilizarse para acceder a la ventana y a sus componentes básicos desde lugares en los que no se dispone de acceso directo a la ventana, sin crear una dependencia de una « id » concreta de la ventana. Un componente QML que utilice las propiedades asociadas de ApplicationWindow funciona en cualquier ventana, independientemente de su « id ».
Áreas seguras
Desde Qt 6.9, ApplicationWindow añadirá automáticamente un relleno a la contentItem para cualquier safe area margins que informe la ventana. Esto garantiza que el contentItem permanezca dentro del área segura de la ventana, mientras que el elemento de fondo cubre toda la ventana.
Si gestionas manualmente los márgenes del área segura en el ` contentItem ` de la ventana, puedes anular el valor por defecto 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 del área segura. Sin embargo, dependiendo del estilo que se utilice, este 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 del foco en los controles de Qt Quick .
Documentación sobre propiedades
activeFocusControl : Control [read-only]
Esta propiedad contiene el control que tiene el foco activo en ese momento, o bien null si no hay ningún control con el foco activo.
La diferencia entre ` Window::activeFocusItem ` y `ApplicationWindow::activeFocusControl` es que el primero puede apuntar a un componente de un control, mientras que el segundo apunta al control que lo contiene. Por ejemplo, cuando ` SpinBox ` tiene el foco, `activeFocusItem` apunta al editor y `activeFocusControl` apunta al propio ` SpinBox `.
Véase también Window::activeFocusItem.
background : Item
Esta propiedad contiene el elemento de fondo.
El elemento de fondo se superpone debajo del « content item », pero por encima del « background color » de la ventana.
El elemento de fondo resulta útil para imágenes y degradados, por ejemplo, pero la propiedad « color » es preferible para colores sólidos, ya que no requiere crear un elemento.
Nota: Si no se especifica ningún tamaño explícito para el elemento de fondo, este adopta automáticamente el tamaño del control. En la mayoría de los casos, no es necesario especificar el ancho ni la altura de un elemento de fondo.
Véase también Personalización deApplicationWindow, 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 especifique explícitamente, el valor refleja el valor de « safe area margins » de la ventana.
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» te permite mezclar libremente elementos visuales hijos, recursos y otras ventanas en un « ApplicationWindow ».
Si asignas un elemento a la lista «contentData», este pasa a ser un elemento secundario del « contentItem » de la ventana, de modo que aparece dentro de la ventana. El elemento principal de dicho elemento será el « contentItem » de la ventana.
Por lo general, no debería ser necesario hacer referencia a la propiedad contentData, ya que es la propiedad predeterminada de ApplicationWindow y, por lo tanto, todos los elementos secundarios 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ñade automáticamente un relleno al `contentItem` para cualquier ` safe area margins ` notificado por la ventana. Para anular el relleno, utiliza las propiedades de relleno individuales.
Véase también background, menuBar, header, footer, topPadding, bottomPadding, leftPadding y rightPadding.
font : font
Esta propiedad contiene la fuente establecida actualmente para la ventana.
La fuente predeterminada depende del entorno del sistema. QGuiApplication mantiene una fuente del sistema o del tema que sirve como predeterminada para todas las ventanas de la aplicación. También puedes establecer la fuente predeterminada para las ventanas pasando una fuente personalizada a QGuiApplication::setFont(), antes de cargar cualquier QML. Por último, la fuente se compara con la base de datos de fuentes de Qt para encontrar la que mejor se ajuste.
ApplicationWindow propaga las propiedades explícitas de la fuente a los controles hijos. Si se modifica una propiedad específica de la fuente de la ventana, dicha 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 del pie de página de la ventana. El elemento del pie de página se sitúa en la parte inferior y se ajusta al ancho de la ventana. El valor por defecto es null.
ApplicationWindow {
footer: ToolBar {
// ...
}
}Nota: Al asignar un valor de « ToolBar », « TabBar » o « DialogButtonBox » al pie de página de la ventana, se establece automáticamente la propiedad correspondiente « ToolBar::position », « TabBar::position » o « DialogButtonBox::position » en « Footer ».
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 sitúa en la parte superior de la ventana, debajo de la barra de menús, y su tamaño se ajusta al ancho de la ventana. El valor por defecto es null.
ApplicationWindow {
header: TabBar {
// ...
}
}Nota: Al asignar un valor de « ToolBar », « TabBar » o « DialogButtonBox » como encabezado de la ventana, se establece automáticamente la propiedad correspondiente « ToolBar::position », « TabBar::position » o « DialogButtonBox::position » en « Header ».
Véase también menuBar, footer y Page::header.
leftPadding : real [since 6.9]
Esta propiedad contiene el relleno a la izquierda del elemento de contenido de la ventana. A menos que se establezca explícitamente, el valor refleja el valor de « safe area margins » de la ventana.
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 predeterminada depende del entorno del sistema. Puedes establecer la configuración regional predeterminada llamando a la función ` QLocale::setDefault()`, antes de cargar cualquier código QML.
ApplicationWindow Propaga la configuración regional a los controles secundarios. Si se cambia la configuración regional de la ventana, esta se propaga a todos los controles secundarios de la ventana, anulando la configuración regional predeterminada 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ús de la ventana. La barra de menús se sitúa en la parte superior de la ventana, encima del encabezado, y su tamaño se ajusta 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 establece el relleno a la derecha del elemento de contenido de la ventana. A menos que se especifique explícitamente, el valor refleja el valor de « safe area margins » de la ventana.
Esta propiedad se introdujo en Qt 6.9.
Véase también « bottomPadding », « leftPadding » y « topPadding ».
topPadding : real [since 6.9]
Esta propiedad establece el relleno superior del elemento de contenido de la ventana. A menos que se especifique explícitamente, el valor refleja el valor de « safe area margins » de la ventana.
Esta propiedad se introdujo en Qt 6.9.
Véase también « bottomPadding », « leftPadding » y « rightPadding ».
Documentación de la propiedad adjunta
ApplicationWindow.activeFocusControl : Control [read-only attached]
Esta propiedad adjunta contiene el control que tiene actualmente el foco activo, o « null » si no hay ningún control con el foco activo. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en una ventana o si la ventana no tiene el foco activo.
Véase también « Window::activeFocusItem » y « Attached ApplicationWindow Properties ».
ApplicationWindow.contentItem : Item [read-only attached]
Esta propiedad adjunta contiene el elemento de contenido de la ventana. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en un « ApplicationWindow ».
Véase también « Attached ApplicationWindow Properties ».
ApplicationWindow.footer : Item [read-only attached]
Esta propiedad adjunta contiene el elemento del pie de página de la ventana. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en un « ApplicationWindow » o si la ventana no tiene ningún elemento de pie de página.
Véase también « Attached ApplicationWindow Properties ».
ApplicationWindow.header : Item [read-only attached]
Esta propiedad adjunta contiene el elemento del encabezado de la ventana. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en un « ApplicationWindow » o si la ventana no tiene ningún elemento de encabezado.
Véase también « Attached ApplicationWindow Properties ».
ApplicationWindow.menuBar : Item [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad adjunta contiene la barra de menús de la ventana. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en un « ApplicationWindow » o si la ventana no tiene barra de menús.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también « Attached ApplicationWindow Properties ».
ApplicationWindow.window : ApplicationWindow [read-only attached]
Esta propiedad adjunta contiene la ventana de la aplicación. La propiedad se puede adjuntar a cualquier elemento. El valor es « null » si el elemento no se encuentra en un « ApplicationWindow ».
Véase también « Attached ApplicationWindow Properties ».
© 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.