ApplicationWindow QML Type

Fenêtre de premier niveau stylisée avec prise en charge d'un en-tête et d'un pied de page. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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)

Propriétés rattachées

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

Description détaillée

ApplicationWindow est un Window qui permet d'ajouter un élément menu bar, header et footer à la fenêtre.

Vous pouvez déclarer ApplicationWindow comme l'élément racine de votre application et l'exécuter en utilisant QQmlApplicationEngine. De cette manière, vous pouvez contrôler les propriétés, l'apparence et la disposition de la fenêtre à partir de QML.

import QtQuick.Controls

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

Propriétés de l'ApplicationWindow attachée

En raison de la manière dont la résolution de la portée et du nom fonctionne en QML, il est possible de référencer le site id de l'élément racine de l'application n'importe où dans ses objets QML enfants. Bien que cette approche convienne à de nombreuses applications et cas d'utilisation, elle peut ne pas être acceptable pour un composant QML générique, car elle crée une dépendance à l'égard de l'environnement.

ApplicationWindow fournit un ensemble de propriétés attachées qui peuvent être utilisées pour accéder à la fenêtre et à ses blocs de construction à partir d'endroits où aucun accès direct à la fenêtre n'est disponible, sans créer de dépendance à l'égard d'une certaine fenêtre id. Un composant QML qui utilise les propriétés attachées à ApplicationWindow fonctionne dans n'importe quelle fenêtre, indépendamment de son id.

Zones sûres

Depuis Qt 6.9, ApplicationWindow ajoutera automatiquement un rembourrage à contentItem pour toute safe area margins signalée par la fenêtre. Cela permet de s'assurer que le contentItem reste dans la zone de sécurité de la fenêtre, tandis que l'élément d'arrière-plan couvre la totalité de la fenêtre.

Si vous définissez manuellement des marges de sécurité dans la fenêtre contentItem, vous pouvez remplacer la valeur par défaut par les propriétés topPadding, leftPadding, rightPadding et bottomPadding:

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

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

Les propriétés header, footer et menuBar ne reçoivent pas de rembourrage automatique pour les marges de sécurité. Cependant, en fonction du style utilisé, le style peut prendre en compte les zones de sécurité dans son implémentation de ToolBar, TabBar, et MenuBar.

Voir aussi Personnaliser ApplicationWindow, Overlay, Page, Contrôles de conteneur, et Gestion du focus dans Qt Quick Contrôles.

Documentation sur les propriétés

activeFocusControl : Control [read-only]

Cette propriété contient le contrôle qui a actuellement le focus actif, ou null s'il n'y a pas de contrôle avec le focus actif.

La différence entre Window::activeFocusItem et ApplicationWindow::activeFocusControl est que le premier peut pointer vers un bloc de construction d'un contrôle, tandis que le second pointe vers le contrôle qui l'entoure. Par exemple, lorsque SpinBox a le focus, activeFocusItem pointe vers l'éditeur et activeFocusControl vers le SpinBox lui-même.

Voir également Window::activeFocusItem.

background : Item

Cette propriété contient l'élément d'arrière-plan.

L'élément d'arrière-plan est empilé sous le content item, mais au-dessus du background color de la fenêtre.

L'élément d'arrière-plan est utile pour les images et les dégradés, par exemple, mais la propriété color est préférable pour les couleurs unies, car elle ne nécessite pas la création d'un élément.

Voir aussi Personnaliser ApplicationWindow, contentItem, header, et footer.

bottomPadding : real [since 6.9]

Cette propriété définit la marge inférieure de l'élément de contenu de la fenêtre. Sauf si elle est explicitement définie, la valeur reflète la valeur de la fenêtre safe area margins.

Cette propriété a été introduite dans Qt 6.9.

Voir également topPadding, leftPadding, et rightPadding.

contentData : list<QtObject> [default]

Cette propriété par défaut contient la liste de tous les objets déclarés comme enfants de la fenêtre.

La propriété data vous permet de mélanger librement les enfants visuels, les ressources et les autres fenêtres dans une fenêtre ApplicationWindow.

Si vous assignez un élément à la liste contentData, il devient un enfant de la fenêtre contentItem, de sorte qu'il apparaît à l'intérieur de la fenêtre. Le parent de l'élément sera la fenêtre contentItem.

Il n'est généralement pas nécessaire de faire référence à la propriété contentData, car il s'agit de la propriété par défaut de ApplicationWindow et tous les éléments enfants sont donc automatiquement affectés à cette propriété.

Voir également contentItem.

contentItem : Item [read-only]

Cette propriété contient l'élément de contenu de la fenêtre.

L'élément de contenu est empilé au-dessus de l'élément background et sous les éléments menuBar, header et footer.

Depuis la version 6.9 de Qt XML, ApplicationWindow ajoute automatiquement un rembourrage à l'élément de contenu pour tout élément safe area margins signalé par la fenêtre. Pour remplacer le rembourrage, utilisez les propriétés de rembourrage individuelles.

Voir aussi background, menuBar, header, footer, topPadding, bottomPadding, leftPadding, et rightPadding.

font : font

Cette propriété contient la police de caractères actuellement définie pour la fenêtre.

La police par défaut dépend de l'environnement du système. QGuiApplication maintient une police système/thème qui sert de police par défaut pour toutes les fenêtres d'application. Vous pouvez également définir la police par défaut pour les fenêtres en passant une police personnalisée à QGuiApplication::setFont(), avant de charger tout QML. Enfin, la police est comparée à la base de données de polices de Qt pour trouver la meilleure correspondance.

ApplicationWindow propage les propriétés de police explicites aux contrôles enfants. Si vous modifiez une propriété spécifique de la police de la fenêtre, cette propriété se propage à tous les contrôles enfants de la fenêtre, en remplaçant les valeurs par défaut du système pour cette propriété.

Voir également Control::font.

footer : Item

Cette propriété contient l'élément de pied de page de la fenêtre. L'élément de pied de page est positionné en bas et redimensionné en fonction de la largeur de la fenêtre. La valeur par défaut est null.

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

Voir également menuBar, header, et Page::footer.

header : Item

Cette propriété contient l'élément d'en-tête de la fenêtre. L'élément d'en-tête est positionné en haut de la fenêtre, sous la barre de menu, et redimensionné en fonction de la largeur de la fenêtre. La valeur par défaut est null.

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

Voir également menuBar, footer, et Page::header.

leftPadding : real [since 6.9]

Cette propriété définit l'espacement à gauche de l'élément de contenu de la fenêtre. Sauf si elle est explicitement définie, la valeur reflète la valeur de la fenêtre safe area margins.

Cette propriété a été introduite dans Qt 6.9.

Voir également bottomPadding, topPadding, et rightPadding.

locale : Locale

Cette propriété indique les paramètres linguistiques de la fenêtre.

La locale par défaut dépend de l'environnement du système. Vous pouvez définir la locale par défaut en appelant QLocale::setDefault(), avant de charger tout QML.

ApplicationWindow propage la locale aux contrôles enfants. Si vous modifiez la locale de la fenêtre, cette locale se propage à tous les contrôles enfants de la fenêtre, en remplaçant la locale par défaut du système.

Voir également Control::locale.

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

Cette propriété contient la barre de menu de la fenêtre. La barre de menu est positionnée en haut de la fenêtre, au-dessus de l'en-tête, et redimensionnée en fonction de la largeur de la fenêtre. La valeur par défaut est null.

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

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi header, footer, et MenuBar.

rightPadding : real [since 6.9]

Cette propriété définit l'espacement à droite de l'élément de contenu de la fenêtre. Sauf si elle est explicitement définie, la valeur reflète la valeur de la fenêtre safe area margins.

Cette propriété a été introduite dans Qt 6.9.

Voir également bottomPadding, leftPadding, et topPadding.

topPadding : real [since 6.9]

Cette propriété définit la marge supérieure de l'élément de contenu de la fenêtre. Sauf si elle est explicitement définie, la valeur reflète la valeur de la fenêtre safe area margins.

Cette propriété a été introduite dans Qt 6.9.

Voir également bottomPadding, leftPadding, et rightPadding.

Documentation sur la propriété Attached

ApplicationWindow.activeFocusControl : Control [read-only]

Cette propriété attachée contient le contrôle qui a actuellement le focus actif, ou null s'il n'y a pas de contrôle avec le focus actif. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans une fenêtre ou si la fenêtre n'a pas de focus actif.

Voir également Window::activeFocusItem et Attached ApplicationWindow Properties.

ApplicationWindow.contentItem : Item [read-only]

Cette propriété jointe contient l'élément de contenu de la fenêtre. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans une ApplicationWindow.

Voir également Attached ApplicationWindow Properties.

ApplicationWindow.footer : Item [read-only]

Cette propriété jointe contient l'élément du pied de page de la fenêtre. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans un ApplicationWindow, ou si la fenêtre n'a pas d'élément de pied de page.

Voir également Attached ApplicationWindow Properties.

ApplicationWindow.header : Item [read-only]

Cette propriété jointe contient l'élément de l'en-tête de la fenêtre. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans un ApplicationWindow, ou si la fenêtre n'a pas d'élément d'en-tête.

Voir également Attached ApplicationWindow Properties.

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

Cette propriété jointe contient la barre de menu de la fenêtre. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans un ApplicationWindow, ou si la fenêtre n'a pas de barre de menu.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi Attached ApplicationWindow Properties.

ApplicationWindow.window : ApplicationWindow [read-only]

Cette propriété attachée contient la fenêtre d'application. Cette propriété peut être attachée à n'importe quel élément. La valeur est null si l'élément n'est pas dans un ApplicationWindow.

Voir également Attached ApplicationWindow Properties.