En esta página

Application QML Type (Singleton)

Proporciona acceso a las propiedades de estado global de la aplicación que comparten muchos componentes QML. Más información...

Import Statement: import QtQuick

Nota: Este tipo es un singleton de QML. Solo hay una instancia de este tipo en el motor de QML.

Propiedades

Señales

Descripción detallada

El singleton Application expone un subconjunto de las propiedades de ` QApplication` a las aplicaciones QML.

También proporciona una señal ` aboutToQuit()`, que es equivalente a ` QCoreApplication::aboutToQuit()`.

import QtQuick

Window {
    id: root
    visible: true
    width: 800
    height: 680

    title: `${Application.name} (${Application.version})`

    Connections {
        target: Application
        function onAboutToQuit() {
            console.log("Bye!")
        }
    }
}

Véase también SystemPalette.

Documentación de propiedades

arguments : list<string>

Se trata de una lista de cadenas que recoge los argumentos con los que se ejecutó el programa.

displayName : string

Esta propiedad representa el nombre que se muestra en la aplicación, tal y como se ha configurado en la instancia de ` QGuiApplication `. Se puede escribir en esta propiedad para establecer el nombre que se muestra en la aplicación.

Binding {
    target: Application
    property: "displayName"
    value: "My Awesome Application"
}

domain : string

Este es el dominio de la organización configurado en la instancia de QCoreApplication. Se puede modificar esta propiedad para establecer el dominio de la organización.

font : font [read-only]

Devuelve la fuente predeterminada de la aplicación tal y como la devuelve la función ` QGuiApplication::font()`.

layoutDirection : enumeration [read-only]

Esta propiedad de solo lectura se puede utilizar para consultar la dirección de diseño predeterminada de la aplicación. Al iniciar el sistema, la dirección de diseño predeterminada depende del idioma de la aplicación. La propiedad tiene el valor « Qt.RightToLeft » en las configuraciones regionales en las que el texto y los elementos gráficos se leen de derecha a izquierda, y « Qt.LeftToRight » cuando la dirección de lectura va de izquierda a derecha. Puedes vincularte a esta propiedad para personalizar los diseños de tu aplicación de modo que admitan ambas direcciones de diseño.

Consulte la enumeración « Qt::LayoutDirection » de C++ para conocer los valores posibles.

RowLayout {
    layoutDirection: Application.layoutDirection
}

name : string

Este es el nombre de la aplicación configurado en la instancia de QCoreApplication. Se puede escribir en esta propiedad para establecer el nombre de la aplicación.

organization : string

Este es el nombre de la organización configurado en la instancia de QCoreApplication. Se puede escribir en esta propiedad para establecer el nombre de la organización.

screens : list<Screen> [read-only]

Un array que contiene las descripciones de todas las pantallas conectadas. Los elementos del array son objetos con las mismas propiedades que el objeto asociado a « Screen ». En la práctica, el array se corresponde con la lista de pantallas devuelta por la función « QGuiApplication::screens()». Además de examinar propiedades como el nombre, el ancho, la altura, etc., los elementos del array también pueden asignarse a la propiedad «screen» de los elementos «Window», sirviendo así como alternativa a la función « QWindow::setScreen()» del lado de C++.

Véase también Screen, Window y Window.screen.

state : enumeration [read-only]

Esta propiedad representa el estado actual de la aplicación.

Consulta la enumeración « Qt::ApplicationState » de C++ para conocer los valores posibles.

Timer {
    interval: 1000; repeat: true
    active: Application.state === Qt.ApplicationActive
    onTriggered: imageFetcher.fetchLatestImages()
}

styleHints : StyleHints [read-only]

La propiedad ` styleHints ` proporciona sugerencias y ajustes de estilo específicos de cada plataforma. Consulta la documentación de ` QStyleHints ` para obtener más detalles.

En el siguiente ejemplo se utiliza styleHints para determinar si un elemento debe recibir el foco al pulsar el botón del ratón o al soltar el toque:

import QtQuick

MouseArea {
    id: button

    onPressed: {
        if (!Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
    onReleased: {
        if (Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
}

supportsMultipleWindows : bool [read-only]

Devuelve « true » si la plataforma admite múltiples ventanas. Algunas plataformas integradas, por ejemplo, no admiten múltiples ventanas.

version : string

Esta es la versión de la aplicación configurada en la instancia de « QCoreApplication ». Se puede escribir en esta propiedad para establecer la versión de la aplicación.

Documentación de Signal

aboutToQuit()

Esta señal se emite cuando la aplicación está a punto de salir del bucle de eventos principal. La señal resulta especialmente útil si la aplicación tiene que realizar alguna tarea de limpieza de última hora. En este estado no es posible la interacción del usuario. Para obtener más información, consulta Window.closing.

Nota: El controlador correspondiente es onAboutToQuit.

Véase también QCoreApplication::aboutToQuit.

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