Application QML Type (Singleton)

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

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

arguments : list<string>

Il s'agit d'une liste de chaînes de caractères correspondant aux arguments avec lesquels l'exécutable a été lancé.

displayName : string

Cette propriété correspond au nom d'affichage de l'application défini sur l'instance QGuiApplication. Il est possible de modifier 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 modifiée pour définir le domaine de l'organisation.

font : font [read-only]

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

layoutDirection : enumeration [read-only]

Cette propriété en lecture seule permet de récupérer la direction de mise en page par défaut de l'application. Au démarrage du système, la direction de mise en page par défaut dépend de la langue de l'application. La propriété prend la valeur « Qt.RightToLeft » dans les paramètres régionaux où le texte et les éléments graphiques se lisent de droite à gauche, et « Qt.LeftToRight » lorsque la direction de lecture va de gauche à droite. Vous pouvez vous lier à cette propriété pour personnaliser la mise en page de votre application afin de prendre en charge les deux sens de mise en page.

Consultez 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. Cette propriété peut être modifiée pour définir le nom de l'application.

organization : string

Il s'agit du nom de l'organisation défini sur l'instance d'QCoreApplication. Cette propriété peut être modifié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 de ce tableau sont des objets présentant les mêmes propriétés que l'objet « Screen » associé. En pratique, ce tableau correspond à la liste d’écrans renvoyée par la fonction QGuiApplication::screens(). Outre l’examen de propriétés telles que le nom, la largeur, la hauteur, etc., les éléments du tableau peuvent également être attribués à la propriété « screen » des éléments Window, servant ainsi d’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.

Consultez l'énumération C++ « Qt::ApplicationState » pour connaître 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 indications de style et des paramètres spécifiques à la plateforme. Pour plus d'informations, consultez la documentation sur ` QStyleHints `.

L'exemple suivant utilise styleHints pour déterminer si un élément doit recevoir le focus lors d'un clic de souris ou du relâchement d'un 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 plateforme prend en charge plusieurs fenêtres. Certaines plateformes embarquées ne prennent pas en charge plusieurs fenêtres, par exemple.

version : string

Il s'agit de la version de l'application définie sur l'instance QCoreApplication. Cette propriété peut être modifiée pour définir la version de l'application.

Documentation Signal

aboutToQuit()

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

Voir également QCoreApplication::aboutToQuit.