Sur cette page

ToolBar QML Type

Conteneur pour les contrôles contextuels. Plus d'informations...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propriétés

Description détaillée

La ToolBar est un conteneur d'actions et de contrôles sensibles au contexte et applicables à l'ensemble de l'application, tels que les boutons de navigation et les champs de recherche. La ToolBar est généralement utilisée comme header ou footer d'une ApplicationWindow.

La ToolBar ne fournit pas de présentation propre, mais vous devez positionner son contenu, par exemple en créant un RowLayout. Si un seul élément est utilisé dans la ToolBar, il sera redimensionné pour s'adapter à la taille implicite de l'élément qu'il contient. C'est pourquoi elle est particulièrement adaptée à une utilisation avec des mises en page.

Barre d'outils contenant des boutons et d'autres commandes

ApplicationWindow {
    visible:true

    header: ToolBar {
        RowLayout {
            anchors.fill: parent
            ToolButton {
                text: qsTr("‹")
                onClicked: stack.pop()
            }
            Label {
                text: "Title"
                elide: Label.ElideRight
                horizontalAlignment: Qt.AlignHCenter
                verticalAlignment: Qt.AlignVCenter
                Layout.fillWidth: true
            }
            ToolButton {
                text: qsTr("⋮")
                onClicked: menu.open()
            }
        }
    }

    StackView {
        id: stack
        anchors.fill: parent
    }
}

Voir également ApplicationWindow, ToolButton, Personnaliser la barre d'outils et les contrôles de conteneurs.

Documentation sur les propriétés

position : enumeration

Cette propriété définit la position de la barre d'outils.

Remarque : Si la barre d'outils est affectée à l'en-tête ou au pied de page de ApplicationWindow ou Page, la position appropriée est définie automatiquement.

Valeurs possibles :

ConstanteDescription : La barre d'outils est en haut, en bas ou en haut de page.
ToolBar.HeaderLa barre d'outils est placée en haut, en tant qu'en-tête de fenêtre ou de page.
ToolBar.FooterLa barre d'outils est placée en bas de page ou de fenêtre.

La valeur par défaut est spécifique au style.

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

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