ApplicationWindow QML Type

Gestaltetes Fenster der obersten Ebene mit Unterstützung für Kopf- und Fußzeile. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• activeFocusControl : Control
• background : Item
• bottomPadding : real (since 6.9)
• contentData : list<QtObject>
• contentItem : Item
• font : font
• footer : Item
• header : Item
• leftPadding : real (since 6.9)
• locale : Locale
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• rightPadding : real (since 6.9)
• topPadding : real (since 6.9)

Zugehörige Eigenschaften

• activeFocusControl : Control
• contentItem : Item
• footer : Item
• header : Item
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• window : ApplicationWindow

Ausführliche Beschreibung

ApplicationWindow ist ein „ Window “, das das Hinzufügen von Elementen wie „ menu bar “, „ header “ und „ footer “ zum Fenster vereinfacht.

Sie können `ApplicationWindow` als Stammelement Ihrer Anwendung deklarieren und es mit ` QQmlApplicationEngine` ausführen. Auf diese Weise können Sie die Eigenschaften, das Erscheinungsbild und das Layout des Fensters über QML steuern.

import QtQuick.Controls

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

Zuordnung von ApplicationWindow-Eigenschaften

Aufgrund der Funktionsweise von „Scope“ und „Naming Resolution“ in QML ist es möglich, an beliebiger Stelle in den untergeordneten QML-Objekten auf das „ id “ des Anwendungsstammelements zu verweisen. Auch wenn dieser Ansatz für viele Anwendungen und Anwendungsfälle geeignet ist, ist er für eine generische QML-Komponente möglicherweise nicht akzeptabel, da er eine Abhängigkeit von der umgebenden Umgebung schafft.

„ApplicationWindow“ stellt eine Reihe von angehängten Eigenschaften bereit, mit denen von Stellen aus, an denen kein direkter Zugriff auf das Fenster möglich ist, auf das Fenster und seine Bausteine zugegriffen werden kann, ohne eine Abhängigkeit von einem bestimmten Fenster- id zu erzeugen. Eine QML-Komponente, die die angehängten Eigenschaften von „ApplicationWindow“ nutzt, funktioniert in jedem Fenster, unabhängig von dessen „ id “.

Sichere Bereiche

Seit Qt 6.9 fügt `ApplicationWindow` automatisch einen Abstand zur ` contentItem ` für jedes vom Fenster gemeldete ` safe area margins ` hinzu. Dadurch wird sichergestellt, dass das ` contentItem ` innerhalb des sicheren Bereichs des Fensters bleibt, während das Hintergrundelement das gesamte Fenster abdeckt.

Wenn Sie die Ränder des sicheren Bereichs im ` contentItem ` des Fensters manuell festlegen, können Sie die Standardeinstellung über die Eigenschaften ` topPadding`, ` leftPadding`, ` rightPadding ` und ` bottomPadding ` überschreiben:

ApplicationWindow {
    // Remove automatic safe area padding
    topPadding: 0

    Flickable {
        // Inset content by safe area margin
        topMargin: SafeArea.margins.top
    }
}

Die Eigenschaften „ header “, „ footer “ und „ menuBar “ erhalten keine automatische Auffüllung für die Ränder des sicheren Bereichs. Je nach verwendetem Stil kann dieser jedoch die sicheren Bereiche bei der Implementierung von „ ToolBar “, „ TabBar “ und „ MenuBar “ berücksichtigen.

Siehe auch „Anpassung von ApplicationWindow“, „ Overlay “, „ Page “, „Container-Steuerelemente“ und „Fokusverwaltung“ unter Qt Quick Controls.

Dokumentation zu den Eigenschaften

activeFocusControl : Control [read-only]

Diese Eigenschaft enthält das Steuerelement, das derzeit den aktiven Fokus hat, oder „ null “, falls kein Steuerelement den aktiven Fokus hat.

Der Unterschied zwischen ` Window::activeFocusItem ` und `ApplicationWindow::activeFocusControl` besteht darin, dass Ersteres auf einen Baustein eines Steuerelements verweisen kann, während Letzteres auf das umschließende Steuerelement verweist. Wenn beispielsweise „ SpinBox “ den Fokus hat, verweist `activeFocusItem` auf den Editor und `activeFocusControl` auf den „ SpinBox “ selbst.

Siehe auch Window::activeFocusItem.

background : Item

Diese Eigenschaft enthält das Hintergrundelement.

Das Hintergrundelement wird unter dem „ content item “ (Fenstertext), aber über dem „ background color “ (Fenstertext) des Fensters angeordnet.

Das Hintergrundelement eignet sich beispielsweise für Bilder und Farbverläufe, für Volltonfarben ist jedoch die Eigenschaft „ color “ vorzuziehen, da hierfür kein Element erstellt werden muss.

Siehe auch „Anpassen von ApplicationWindow“, „ contentItem “, „ header “ und „ footer “.

bottomPadding : real [since 6.9]

Diese Eigenschaft gibt den unteren Abstand des Inhaltselements des Fensters an. Sofern nicht explizit festgelegt, entspricht der Wert dem Wert von „ safe area margins “ des Fensters.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch „ topPadding “, „ leftPadding “ und „ rightPadding “.

contentData : list<QtObject> [default]

Diese Standardeigenschaft enthält die Liste aller Objekte, die als untergeordnete Elemente des Fensters deklariert wurden.

Die Eigenschaft „data“ ermöglicht es Ihnen, visuelle untergeordnete Elemente, Ressourcen und andere Fenster in einem „ ApplicationWindow “ beliebig zu mischen.

Wenn Sie der Liste „contentData“ ein Element zuweisen, wird dieses zu einem untergeordneten Element des „ contentItem “ des Fensters, sodass es innerhalb des Fensters angezeigt wird. Das übergeordnete Element des zugewiesenen Elements ist das „ contentItem “ des Fensters.

Im Allgemeinen sollte es nicht notwendig sein, auf die Eigenschaft „contentData“ zu verweisen, da es sich um die Standardeigenschaft für „ ApplicationWindow “ handelt und somit alle untergeordneten Elemente automatisch dieser Eigenschaft zugewiesen werden.

Siehe auch „ contentItem “.

contentItem : Item [read-only]

Diese Eigenschaft enthält das Fenster-Inhaltselement.

Das Inhaltselement wird über dem Element „ background “ und unter den Elementen „ menuBar “, „ header “ und „ footer “ angeordnet.

Seit Qt 6.9 fügt „ ApplicationWindow “ automatisch einen Abstand zum „contentItem“ hinzu, wenn vom Fenster ein „ safe area margins “ gemeldet wird. Um diesen Abstand zu überschreiben, verwenden Sie die einzelnen Abstandseigenschaften.

Siehe auch „ background“ , „ menuBar “, „ header “, „ footer “, „ topPadding “, „ bottomPadding “, „ leftPadding “ und „ rightPadding “.

font : font

Diese Eigenschaft enthält die derzeit für das Fenster festgelegte Schriftart.

Die Standardschriftart hängt von der Systemumgebung ab. „ QGuiApplication “ verwaltet eine System-/Design-Schriftart, die als Standard für alle Anwendungsfenster dient. Sie können die Standardschriftart für Fenster auch festlegen, indem Sie vor dem Laden von QML eine benutzerdefinierte Schriftart an „ QGuiApplication::setFont()“ übergeben. Schließlich wird die Schriftart mit der Qt-Schriftartendatenbank abgeglichen, um die beste Übereinstimmung zu finden.

ApplicationWindow Leitet explizite Schriftarteneigenschaften an untergeordnete Steuerelemente weiter. Wenn Sie eine bestimmte Eigenschaft der Schriftart des Fensters ändern, wird diese Eigenschaft an alle untergeordneten Steuerelemente im Fenster weitergegeben und überschreibt dabei alle Systemstandardwerte für diese Eigenschaft.

Siehe auch Control::font.

footer : Item

Diese Eigenschaft enthält das Fußzeilenelement des Fensters. Das Fußzeilenelement wird am unteren Rand positioniert und auf die Breite des Fensters angepasst. Der Standardwert lautet „ null “.

ApplicationWindow {
    footer: ToolBar {
        // ...
    }
}

Siehe auch menuBar, header und Page::footer.

header : Item

Diese Eigenschaft enthält das Kopfzeilenelement des Fensters. Das Kopfzeilenelement wird oben im Fenster unterhalb der Menüleiste positioniert und an die Breite des Fensters angepasst. Der Standardwert lautet „ null “.

ApplicationWindow {
    header: TabBar {
        // ...
    }
}

Siehe auch „ menuBar “, „ footer “ und „ Page::header “.

leftPadding : real [since 6.9]

Diese Eigenschaft gibt den linken Abstand des Inhaltselements des Fensters an. Sofern nicht explizit festgelegt, entspricht der Wert dem Wert von „ safe area margins “ des Fensters.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch „ bottomPadding “, „ topPadding “ und „ rightPadding “.

locale : Locale

Diese Eigenschaft enthält die Locale des Fensters.

Die Standard-Locale hängt von der Systemumgebung ab. Sie können die Standard-Locale festlegen, indem Sie vor dem Laden von QML die Funktion ` QLocale::setDefault()` aufrufen.

ApplicationWindow Die Locale wird an untergeordnete Steuerelemente weitergegeben. Wenn Sie die Locale des Fensters ändern, wird diese Locale an alle untergeordneten Steuerelemente im Fenster weitergegeben und überschreibt dabei die Standard-Locale des Systems.

Siehe auch „ Control::locale “.

menuBar : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft enthält die Menüleiste des Fensters. Die Menüleiste befindet sich am oberen Rand des Fensters, oberhalb der Kopfzeile, und passt sich an die Breite des Fensters an. Der Standardwert lautet „ null “.

ApplicationWindow {
    menuBar: MenuBar {
        // ...
    }
}

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch „ header “, „ footer “ und „ MenuBar “.

rightPadding : real [since 6.9]

Diese Eigenschaft gibt den rechten Abstand des Inhaltselements des Fensters an. Sofern nicht explizit festgelegt, entspricht der Wert dem Wert von „ safe area margins “ des Fensters.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch „ bottomPadding “, „ leftPadding “ und „ topPadding “.

topPadding : real [since 6.9]

Diese Eigenschaft gibt den oberen Abstand des Inhaltselements des Fensters an. Sofern nicht explizit festgelegt, entspricht der Wert dem Wert von „ safe area margins “ des Fensters.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch „ bottomPadding “, „ leftPadding “ und „ rightPadding “.

Dokumentation zu angehängten Eigenschaften

ApplicationWindow.activeFocusControl : Control [read-only attached]

Diese angehängte Eigenschaft enthält das Steuerelement, das derzeit den aktiven Fokus hat, oder „ null “, falls kein Steuerelement den aktiven Fokus hat. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einem Fenster befindet oder das Fenster keinen aktiven Fokus hat.

Siehe auch „ Window::activeFocusItem “ und „ Attached ApplicationWindow Properties “.

ApplicationWindow.contentItem : Item [read-only attached]

Diese angehängte Eigenschaft enthält das Fenster-Inhaltselement. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einem „ ApplicationWindow “ befindet.

Siehe auch „ Attached ApplicationWindow Properties “.

ApplicationWindow.footer : Item [read-only attached]

Diese angehängte Eigenschaft enthält das Fußzeilenelement des Fensters. Die Eigenschaft kann an jedes beliebige Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einer „ ApplicationWindow “ befindet oder das Fenster kein Fußzeilenelement hat.

Siehe auch „ Attached ApplicationWindow Properties “.

ApplicationWindow.header : Item [read-only attached]

Diese angehängte Eigenschaft enthält das Kopfelement des Fensters. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einem „ ApplicationWindow “ befindet oder das Fenster kein Kopfelement hat.

Siehe auch „ Attached ApplicationWindow Properties “.

ApplicationWindow.menuBar : Item [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese angehängte Eigenschaft enthält die Menüleiste des Fensters. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einem „ ApplicationWindow “ befindet oder das Fenster keine Menüleiste hat.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch „ Attached ApplicationWindow Properties “.

ApplicationWindow.window : ApplicationWindow [read-only attached]

Diese angehängte Eigenschaft enthält das Anwendungsfenster. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert lautet „ null “, wenn sich das Element nicht in einem „ ApplicationWindow “ befindet.

Siehe auch „ Attached ApplicationWindow Properties “.