Application QML Type (Singleton)

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

Remarque : ce type est un singleton QML. Il n'existe qu'une seule instance de ce type dans le moteur QML.

• Liste de tous les membres, y compris les membres hérités
• Membres obsolètes

Propriétés

• arguments : list<string>
• displayName : string
• domain : string
• font : font
• layoutDirection : enumeration
• name : string
• organization : string
• screens : list<Screen>
• state : enumeration
• styleHints : StyleHints
• supportsMultipleWindows : bool
• version : string

Signaux

• aboutToQuit()

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 sur les propriétés

arguments : list<string>

Il s'agit d'une liste de chaînes de caractères contenant les 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. On peut é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 d'organisation défini sur l'instance QCoreApplication. Il est possible d'écrire dans cette propriété pour définir le domaine de l'organisation.

font : font [read-only]

Renvoie la police d'application par défaut telle que 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 pour les langues dans lesquelles le texte et les éléments graphiques sont lus de droite à gauche, et Qt.LeftToRight pour les langues dans lesquelles 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 sur l'instance QCoreApplication. On peut écrire dans cette propriété pour définir le nom de l'application.

organization : string

Il s'agit du nom de l'organisation défini sur l'instance QCoreApplication. On peut écrire dans cette propriété 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 aussi 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 les fenêtres multiples. Certaines plates-formes intégré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 sur l'instance QCoreApplication. On peut écrire dans cette propriété pour définir la version de l'application.

Documentation sur les signaux

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.

Voir également QCoreApplication::aboutToQuit.