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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

activeFocusControl : Control
background : Item
contentData : list<QtObject>
contentItem : Item
font : font
footer : Item
header : Item
locale : Locale
menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))

Beigefügte 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 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-Root-Elements überall in seinen 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.

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.

contentData : list<QtObject> [default]

Diese Standardeigenschaft enthält die Liste aller Objekte, die als Unterobjekte des Fensters deklariert sind.

Die Eigenschaft data ermöglicht 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.

Siehe auch background, menuBar, header, und footer.

font : font

Diese Eigenschaft enthält die Schriftart, die derzeit für das Fenster eingestellt ist.

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.

locale : Locale

Diese Eigenschaft enthält das Gebietsschema des Fensters.

Das Standardgebietsschema hängt von der Systemumgebung ab. Sie können das Standardgebietsschema durch den Aufruf von QLocale::setDefault() festlegen, 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.

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

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.

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 ein beliebiges 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.

ApplicationWindow.footer : Item [read-only]

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.

ApplicationWindow.menuBar : Item [read-only, 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 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.