Application QML Type (Singleton)

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

Hinweis: Dieser Typ ist ein QML Singleton. Es gibt nur eine Instanz dieses Typs in der QML-Engine.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Veraltete Mitglieder

Eigenschaften

• 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

Signale

• aboutToQuit()

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 Eigenschaften

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 in der Instanz QGuiApplication festgelegt wurde. Auf diese Eigenschaft kann geschrieben werden, um den Anzeigenamen der Anwendung festzulegen.

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

domain : string

Dies ist die Organisationsdomäne, die in der Instanz QCoreApplication eingestellt ist. Diese Eigenschaft kann beschrieben werden, um die Organisationsdomäne festzulegen.

font : font [read-only]

Gibt die Standard-Anwendungsschrift 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 den Wert 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 in der Instanz QCoreApplication eingestellte Anwendungsname. Auf diese Eigenschaft kann geschrieben werden, um den Anwendungsnamen festzulegen.

organization : string

Dies ist der in der Instanz QCoreApplication festgelegte Organisationsname. Diese Eigenschaft kann beschrieben werden, um den Organisationsnamen festzulegen.

screens : list<Screen> [read-only]

Ein Array, das die Beschreibungen aller angeschlossenen Bildschirme enthält. Die Elemente des Arrays sind Objekte mit denselben 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.ApplicationActive
    onTriggered: imageFetcher.fetchLatestImages()
}

styleHints : StyleHints [read-only]

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

Das folgende Beispiel verwendet styleHints, um zu bestimmen, ob ein Element beim Drücken der Maus oder beim Loslassen der Berührung den Fokus 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 in der Instanz QCoreApplication eingestellte Anwendungsversion. 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. Für weitere Informationen siehe Window.closing.

Siehe auch QCoreApplication::aboutToQuit.