Sur cette page

ToolBar QML Type

Conteneur pour les contrôles contextuels. En savoir plus...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propriétés

Description détaillée

ToolBar est un conteneur d'actions et de contrôles valables à l'échelle de l'application et sensibles au contexte, tels que des boutons de navigation et des champs de recherche. ToolBar est couramment utilisé comme header ou comme footer d'un ApplicationWindow.

ToolBar ne fournit pas de mise en page propre, mais vous oblige à positionner son contenu, par exemple en créant une « RowLayout ». Si un seul élément est utilisé au sein de la ToolBar, celle-ci s'adaptera à la taille implicite de l'élément qu'elle contient. Cela la rend particulièrement adaptée à une utilisation avec des mises en page.

Barre d'outils contenant des boutons et d'autres éléments de commande

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, Personnalisation de ToolBar et Contrôles 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 définie comme en-tête ou pied de page d'un document de type « ApplicationWindow » ou « Page », la position appropriée est définie automatiquement.

Valeurs possibles :

ConstanteDescription
ToolBar.HeaderLa barre d'outils se trouve en haut, en tant qu'en-tête de fenêtre ou de page.
ToolBar.FooterLa barre d'outils se trouve en bas, en tant que pied de page de la fenêtre ou de la page.

La valeur par défaut dépend du 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.