Back to Qt.io
Contact Us Blog Download Qt

ApplicationWindow QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Window

Eigenschaften

Beigefügte Eigenschaften

Ausführliche Beschreibung

ApplicationWindow ist ein Window, das es ermöglicht, dem Fenster ein menu bar, header und footer Element hinzuzufügen.

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

import QtQuick.Controls 2.12

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

Hinweis: Standardmäßig ist ein ApplicationWindow nicht sichtbar.

Angehängte ApplicationWindow-Eigenschaften

Aufgrund der Art und Weise, wie Scope und Naming Resolution in QML funktionieren, ist es möglich, die id des Anwendungs-Wurzelelements überall in dessen untergeordneten QML-Objekten zu referenzieren. Obwohl dieser Ansatz für viele Anwendungen und Anwendungsfälle gut geeignet ist, ist er für eine generische QML-Komponente möglicherweise nicht akzeptabel, da er eine Abhängigkeit von der Umgebung schafft.

ApplicationWindow bietet eine Reihe von angehängten Eigenschaften, die verwendet werden können, um auf das Fenster und seine Bausteine von Stellen aus zuzugreifen, an denen kein direkter Zugriff auf das Fenster möglich ist, ohne eine Abhängigkeit von einem bestimmten Fenster zu schaffen id. Eine QML-Komponente, die die angehängten Eigenschaften von ApplicationWindow verwendet, funktioniert in jedem Fenster, unabhängig von dessen id.

Sichere Bereiche

Seit Qt 6.9 fügt ApplicationWindow automatisch Padding zu contentItem für alle vom Fenster gemeldeten safe area margins hinzu. Dies stellt sicher, dass die 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 einstellen, können Sie den Standard über die Eigenschaften topPadding, leftPadding, rightPadding und bottomPadding außer Kraft setzen:

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 der Stil jedoch sichere Bereiche in seiner Implementierung von ToolBar, TabBar und MenuBar berücksichtigen.

Siehe auch Customizing ApplicationWindow, Overlay, Page, Container Controls und Focus Management in Qt Quick Controls.

Eigenschaft Dokumentation

activeFocusControl : Control [read-only]

Diese Eigenschaft enthält das Steuerelement, das derzeit den aktiven Fokus hat, oder null, wenn es kein Steuerelement mit aktivem Fokus gibt.

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 zum Beispiel SpinBox den Fokus hat, zeigt activeFocusItem auf den Editor und activeFocusControl auf SpinBox selbst.

Siehe auch Window::activeFocusItem.


background : Item

Diese Eigenschaft enthält das Hintergrundelement.

Das Hintergrundelement wird unter dem content item, aber über dem background color des Fensters angeordnet.

Das Hintergrundelement ist z. B. für Bilder und Farbverläufe nützlich, aber die Eigenschaft color ist für Volltonfarben vorzuziehen, da sie kein Element erstellen muss.

Hinweis: Wenn für das Hintergrundelement keine explizite Größe angegeben ist, folgt es automatisch der Größe des Steuerelements. In den meisten Fällen ist es nicht erforderlich, Breite oder Höhe für ein Hintergrundelement anzugeben.

Siehe auch Customizing ApplicationWindow, contentItem, header, und footer.


bottomPadding : real [since 6.9]

Diese Eigenschaft enthält die untere Auffüllung des Inhaltselements des Fensters. Sofern nicht explizit festgelegt, spiegelt der Wert die safe area margins des Fensters wider.

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 Kinder des Fensters deklariert sind.

Die Eigenschaft data erlaubt es Ihnen, visuelle Kinder, Ressourcen und andere Fenster in einem ApplicationWindow frei zu mischen.

Wenn Sie der contentData-Liste ein Objekt zuweisen, wird es zu einem untergeordneten Objekt des Fensters contentItem, so dass es innerhalb des Fensters erscheint. Das Elternteil des Elements ist das contentItem des Fensters.

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

Siehe auch contentItem.


contentItem : Item [read-only]

Diese Eigenschaft enthält das Inhaltselement des Fensters.

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

Seit Qt 6.9 fügt ApplicationWindow automatisch Padding zum contentItem für jedes vom Fenster gemeldete safe area margins hinzu. Um das Padding zu überschreiben, verwenden Sie die individuellen Padding-Eigenschaften.

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


font : font

Diese Eigenschaft enthält die aktuell für das Fenster eingestellte Schriftart.

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

ApplicationWindow überträgt explizite Schrifteigenschaften auf untergeordnete Steuerelemente. Wenn Sie eine bestimmte Eigenschaft der Schriftart des Fensters ändern, wird diese Eigenschaft auf alle untergeordneten Steuerelemente im Fenster übertragen und überschreibt alle Systemvorgaben für diese Eigenschaft.

Siehe auch Control::font.


Diese Eigenschaft enthält das Fußzeilenelement des Fensters. Das Fußzeilenelement wird am unteren Rand positioniert und in der Größe an die Breite des Fensters angepasst. Der Standardwert ist null.

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

Hinweis: Wenn Sie ToolBar, TabBar oder DialogButtonBox als Fußzeile des Fensters zuweisen, wird die entsprechende Eigenschaft ToolBar::position, TabBar::position oder DialogButtonBox::position automatisch auf Footer gesetzt.

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


header : Item

Diese Eigenschaft enthält die Kopfzeile des Fensters. Die Kopfzeile wird am oberen Rand des Fensters, unterhalb der Menüleiste, positioniert und auf die Breite des Fensters angepasst. Der Standardwert ist null.

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

Hinweis: Wenn Sie ToolBar, TabBar oder DialogButtonBox als Fensterkopf zuweisen, wird die entsprechende Eigenschaft ToolBar::position, TabBar::position oder DialogButtonBox::position automatisch auf Header gesetzt.

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


leftPadding : real [since 6.9]

Diese Eigenschaft enthält die linke Auffüllung des Inhaltselements des Fensters. Sofern nicht explizit gesetzt, spiegelt der Wert die safe area margins des Fensters wider.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch bottomPadding, topPadding, und rightPadding.


locale : Locale

Diese Eigenschaft enthält das Gebietsschema des Fensters.

Das Standardgebietsschema hängt von der Systemumgebung ab. Sie können die Standard-Locale durch den Aufruf von QLocale::setDefault() setzen, bevor Sie QML laden.

ApplicationWindow überträgt das Gebietsschema auf untergeordnete Steuerelemente. Wenn Sie das Gebietsschema des Fensters ändern, wird dieses Gebietsschema auf alle untergeordneten Steuerelemente des Fensters übertragen und überschreibt das Standardgebietsschema des Systems.

Siehe auch Control::locale.


Diese Eigenschaft enthält die Menüleiste des Fensters. Die Menüleiste wird am oberen Rand des Fensters über der Kopfzeile positioniert und in der Größe an die Breite des Fensters angepasst. Der Standardwert ist 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 Padding-Wert des Inhaltselements des Fensters an. Sofern nicht explizit festgelegt, spiegelt der Wert die safe area margins des Fensters wider.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch bottomPadding, leftPadding, und topPadding.


topPadding : real [since 6.9]

Diese Eigenschaft enthält den oberen Abstand des Inhaltselements des Fensters. Sofern nicht explizit festgelegt, spiegelt der Wert die safe area margins des Fensters wider.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch bottomPadding, leftPadding, und rightPadding.


Dokumentation der Eigenschaft Attached

ApplicationWindow.activeFocusControl : Control [read-only]

Diese angehängte Eigenschaft enthält das Steuerelement, das derzeit den aktiven Fokus hat, oder null, wenn es kein Steuerelement mit aktivem Fokus gibt. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert ist 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]

Diese angehängte Eigenschaft enthält das Fensterinhaltselement. Die Eigenschaft kann an ein beliebiges Element angehängt werden. Der Wert ist null, wenn sich das Element nicht in einem ApplicationWindow befindet.

Siehe auch Attached ApplicationWindow Properties.


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

Siehe auch Attached ApplicationWindow Properties.


ApplicationWindow.header : Item [read-only]

Diese angehängte Eigenschaft enthält die Kopfzeile des Fensters. Die Eigenschaft kann an jedes beliebige Element angehängt werden. Der Wert ist null, wenn sich das Element nicht in einem ApplicationWindow befindet oder das Fenster kein Kopfzeilen-Element hat.

Siehe auch Attached ApplicationWindow Properties.


Diese angehängte Eigenschaft enthält die Menüleiste des Fensters. Die Eigenschaft kann an jedes Element angehängt werden. Der Wert ist 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]

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

Siehe auch Attached ApplicationWindow Properties.


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