En esta página

ToolBar QML Type

Contenedor para controles sensibles al contexto. Más...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propiedades

Descripción detallada

ToolBar es un contenedor de acciones y controles válidos para toda la aplicación y sensibles al contexto, como botones de navegación y campos de búsqueda. ToolBar se utiliza habitualmente como header o como footer de un ApplicationWindow.

ToolBar no proporciona un diseño propio, sino que requiere que se posicione su contenido, por ejemplo, creando un « RowLayout ». Si solo se utiliza un único elemento dentro de ToolBar, este se redimensionará para adaptarse al tamaño implícito del elemento que contiene. Esto lo hace especialmente adecuado para su uso junto con diseños.

Barra de herramientas que contiene botones y otros controles

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
    }
}

Véase también ApplicationWindow, ToolButton, Personalización de ToolBar y Controles contenedores.

Documentación de propiedades

position : enumeration

Esta propiedad determina la posición de la barra de herramientas.

Nota: Si la barra de herramientas se asigna como encabezado o pie de página de ApplicationWindow o Page, la posición adecuada se establece automáticamente.

Valores posibles:

ConstanteDescripción
ToolBar.HeaderLa barra de herramientas se encuentra en la parte superior, como encabezado de una ventana o de una página.
ToolBar.FooterLa barra de herramientas se encuentra en la parte inferior, como pie de página de la ventana o de la página.

El valor por defecto depende del estilo.

Véase también ApplicationWindow::header, ApplicationWindow::footer, Page::header y 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.