Application QML Type

Ermöglicht den Zugriff auf globale Anwendungszustandseigenschaften, die von vielen QML-Komponenten gemeinsam genutzt werden. Mehr...

Import Statement: import QtQuick

Eigenschaften

Signale

Detaillierte Beschreibung

Das Application-Singleton stellt eine Teilmenge der Eigenschaften von QApplication für QML-Anwendungen zur Verfügung.

Es bietet auch ein aboutToQuit()-Signal, das dasselbe ist wie 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!")
        }
    }
}

Siehe auch SystemPalette.

Dokumentation der Eigenschaft

arguments : list<string>

Dies ist eine String-Liste der Argumente, mit denen die ausführbare Datei aufgerufen wurde.


displayName : string

Diese Eigenschaft stellt den Anzeigenamen der Anwendung dar, der für die Instanz QGuiApplication festgelegt wurde. Auf diese Eigenschaft kann geschrieben werden, um den Anzeigenamen der Anwendung zu setzen.

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

domain : string

Dies ist die Organisationsdomäne, die auf der Instanz QCoreApplication eingestellt ist. In diese Eigenschaft kann geschrieben werden, um die Organisationsdomäne festzulegen.


font : font [read-only]

Gibt die Standard-Anwendungsschriftart zurück, die von QGuiApplication::font() zurückgegeben wird.


layoutDirection : enumeration [read-only]

Diese schreibgeschützte Eigenschaft kann verwendet werden, um die Standard-Layoutrichtung der Anwendung abzufragen. Beim Systemstart hängt die Standard-Layoutrichtung von der Sprache der Anwendung ab. Die Eigenschaft hat einen Wert von Qt.RightToLeft in Sprachumgebungen, in denen Text und grafische Elemente von rechts nach links gelesen werden, und Qt.LeftToRight, wo die Leserichtung von links nach rechts verläuft. Sie können an diese Eigenschaft binden, um Ihre Anwendungslayouts so anzupassen, dass beide Layoutrichtungen unterstützt werden.

Siehe das C++ Qt::LayoutDirection enum für mögliche Werte.

RowLayout {
    layoutDirection: Application.layoutDirection
}

name : string

Dies ist der Anwendungsname, der in der Instanz QCoreApplication festgelegt wurde. Auf diese Eigenschaft kann geschrieben werden, um den Anwendungsnamen zu setzen.


organization : string

Dies ist der Organisationsname, der in der Instanz QCoreApplication eingestellt ist. Diese Eigenschaft kann beschrieben werden, um den Namen der Organisation festzulegen.


screens : list<Screen> [read-only]

Ein Array, das die Beschreibungen aller angeschlossenen Bildschirme enthält. Die Elemente des Arrays sind Objekte mit den gleichen Eigenschaften wie das angehängte Objekt Screen. In der Praxis entspricht das Array der Bildschirmliste, die von QGuiApplication::screens() zurückgegeben wird. Neben der Untersuchung von Eigenschaften wie Name, Breite, Höhe usw. können die Array-Elemente auch der Screen-Eigenschaft von Window-Elementen zugewiesen werden und dienen somit als Alternative zu QWindow::setScreen() auf der C++-Seite.

Siehe auch Screen, Window, und Window.screen.


state : enumeration [read-only]

Diese Eigenschaft stellt den aktuellen Zustand der Anwendung dar.

Siehe das C++ Qt::ApplicationState enum für mögliche Werte.

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

styleHints : StyleHints [read-only]

Die Eigenschaft styleHints bietet plattformspezifische Style-Hinweise und Einstellungen. Weitere Einzelheiten finden Sie in der Dokumentation QStyleHints.

Das folgende Beispiel verwendet styleHints, um zu bestimmen, ob ein Element den Fokus beim Drücken der Maus oder beim Loslassen der Berührung erhalten soll:

import QtQuick

MouseArea {
    id: button

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

supportsMultipleWindows : bool [read-only]

Gibt true zurück, wenn die Plattform mehrere Fenster unterstützt. Einige eingebettete Plattformen unterstützen z. B. nicht mehrere Fenster.


version : string

Dies ist die Anwendungsversion, die in der Instanz QCoreApplication eingestellt ist. Auf diese Eigenschaft kann geschrieben werden, um die Anwendungsversion zu setzen.


Signal Dokumentation

aboutToQuit()

Dieses Signal wird ausgegeben, wenn die Anwendung im Begriff ist, die Hauptereignisschleife zu verlassen. Das Signal ist besonders nützlich, wenn Ihre Anwendung in letzter Sekunde einige Aufräumarbeiten durchführen muss. In diesem Zustand ist keine Benutzerinteraktion möglich. Weitere Informationen finden Sie unter Window.closing.

Hinweis: Der entsprechende Handler ist onAboutToQuit.

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