Application QML Type

Permet d'accéder aux propriétés globales de l'état de l'application partagées par de nombreux composants QML. Plus d'informations...

Import Statement: import QtQuick

Propriétés

Signaux

Description détaillée

Le singleton Application expose un sous-ensemble des propriétés de QApplication aux applications QML.

Il fournit également un signal aboutToQuit(), qui est identique à 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!")
        }
    }
}

Voir également SystemPalette.

Documentation des propriétés

arguments : list<string>

Il s'agit d'une liste sous forme de chaîne de caractères des arguments avec lesquels l'exécutable a été invoqué.


displayName : string

Cette propriété représente le nom d'affichage de l'application défini sur l'instance QGuiApplication. Il est possible d'écrire dans cette propriété pour définir le nom d'affichage de l'application.

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

domain : string

Il s'agit du domaine de l'organisation défini sur l'instance QCoreApplication. Cette propriété peut être utilisée pour définir le domaine de l'organisation.


font : font [read-only]

Renvoie la police d'application par défaut telle qu'elle est renvoyée par QGuiApplication::font().


layoutDirection : enumeration [read-only]

Cette propriété en lecture seule peut être utilisée pour demander le sens de présentation par défaut de l'application. Au démarrage du système, le sens de présentation par défaut dépend de la langue de l'application. La valeur de cette propriété est Qt.RightToLeft dans les langues où le texte et les éléments graphiques sont lus de droite à gauche, et Qt.LeftToRight dans les langues où le sens de lecture va de gauche à droite. Vous pouvez vous lier à cette propriété pour personnaliser la présentation de vos applications afin de prendre en charge les deux sens de lecture.

Voir l'énumération C++ Qt::LayoutDirection pour connaître les valeurs possibles.

RowLayout {
    layoutDirection: Application.layoutDirection
}

name : string

Il s'agit du nom de l'application défini dans l'instance QCoreApplication. Cette propriété peut être écrite pour définir le nom de l'application.


organization : string

Il s'agit du nom de l'organisation défini dans l'instance QCoreApplication. Cette propriété peut être utilisée pour définir le nom de l'organisation.


screens : list<Screen> [read-only]

Un tableau contenant les descriptions de tous les écrans connectés. Les éléments du tableau sont des objets ayant les mêmes propriétés que l'objet attaché à Screen. En pratique, le tableau correspond à la liste d'écrans renvoyée par QGuiApplication::screens(). Outre l'examen des propriétés telles que le nom, la largeur, la hauteur, etc., les éléments du tableau peuvent également être affectés à la propriété screen des éléments Window, ce qui constitue une alternative à la fonction QWindow::setScreen() du côté C++.

Voir également Screen, Window, et Window.screen.


state : enumeration [read-only]

Cette propriété représente l'état actuel de l'application.

Voir l'énumération C++ Qt::ApplicationState pour les valeurs possibles.

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

styleHints : StyleHints [read-only]

La propriété styleHints fournit des conseils et des paramètres de style spécifiques à la plate-forme. Voir la documentation QStyleHints pour plus de détails.

L'exemple suivant utilise styleHints pour déterminer si un élément doit être mis au premier plan lors de l'appui sur la souris ou du relâchement du toucher :

import QtQuick

MouseArea {
    id: button

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

supportsMultipleWindows : bool [read-only]

Renvoie true si la plate-forme prend en charge plusieurs fenêtres. Certaines plateformes embarquées ne prennent pas en charge les fenêtres multiples, par exemple.


version : string

Il s'agit de la version de l'application définie dans l'instance QCoreApplication. Il est possible d'écrire dans cette propriété pour définir la version de l'application.


Signal Documentation

aboutToQuit()

Ce signal est émis lorsque l'application est sur le point de quitter la boucle d'événements principale. Ce signal est particulièrement utile si votre application doit effectuer un nettoyage de dernière minute. L'interaction avec l'utilisateur n'est pas possible dans cet état. Pour plus d'informations, voir Window.closing.

Remarque : le gestionnaire correspondant est onAboutToQuit.

Voir également QCoreApplication::aboutToQuit.


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