En esta página

QToolBar Class

La clase QToolBar proporciona un panel desplazable que contiene un conjunto de controles. Más información...

Encabezado: #include <QToolBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QWidget

Propiedades

Funciones públicas

QToolBar(QWidget *parent = nullptr)
QToolBar(const QString &title, QWidget *parent = nullptr)
virtual ~QToolBar()
QAction *actionAt(const QPoint &p) const
QAction *actionAt(int x, int y) const
QAction *addSeparator()
QAction *addWidget(QWidget *widget)
Qt::ToolBarAreas allowedAreas() const
void clear()
QSize iconSize() const
QAction *insertSeparator(QAction *before)
QAction *insertWidget(QAction *before, QWidget *widget)
bool isAreaAllowed(Qt::ToolBarArea area) const
bool isFloatable() const
bool isFloating() const
bool isMovable() const
Qt::Orientation orientation() const
void setAllowedAreas(Qt::ToolBarAreas areas)
void setFloatable(bool floatable)
void setMovable(bool movable)
void setOrientation(Qt::Orientation orientation)
QAction *toggleViewAction() const
Qt::ToolButtonStyle toolButtonStyle() const
QWidget *widgetForAction(QAction *action) const

Ranuras públicas

void setIconSize(const QSize &iconSize)
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

Señales

void actionTriggered(QAction *action)
void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)
void iconSizeChanged(const QSize &iconSize)
void movableChanged(bool movable)
void orientationChanged(Qt::Orientation orientation)
void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)
void topLevelChanged(bool topLevel)
void visibilityChanged(bool visible)

Funciones protegidas reimplementadas

virtual void actionEvent(QActionEvent *event) override
virtual void changeEvent(QEvent *event) override
virtual bool event(QEvent *event) override
virtual void paintEvent(QPaintEvent *event) override

Descripción detallada

Normalmente, una barra de herramientas se crea llamando a ` QMainWindow::addToolBar(const QString &title)`, pero también se puede añadir como primer widget en un ` QVBoxLayout`, por ejemplo.

Los botones de la barra de herramientas se añaden mediante acciones, utilizando addAction() o insertAction(). Los grupos de botones se pueden separar utilizando addSeparator() o insertSeparator(). Si un botón de la barra de herramientas no resulta adecuado, se puede insertar un widget en su lugar utilizando addWidget() o insertWidget(). Algunos ejemplos de widgets adecuados son QSpinBox, QDoubleSpinBox y QComboBox. Cuando se pulsa un botón de la barra de herramientas, este emite la señal actionTriggered().

Una barra de herramientas puede fijarse en una zona concreta (por ejemplo, en la parte superior de la ventana) o bien desplazarse entre distintas zonas de la barra; véase setMovable(), isMovable(), allowedAreas() y isAreaAllowed().

Cuando se cambia el tamaño de una barra de herramientas de tal forma que resulta demasiado pequeña para mostrar todos los elementos que contiene, aparecerá un botón de extensión como último elemento de la barra. Al pulsar el botón de extensión, se abrirá un menú emergente que contiene los elementos que actualmente no caben en la barra de herramientas.

Cuando una QToolBar no es un elemento secundario de un QMainWindow, pierde la capacidad de rellenar el menú emergente de extensión con los widgets añadidos a la barra de herramientas mediante addWidget(). En su lugar, utiliza acciones de widget creadas heredando de QWidgetAction e implementando QWidgetAction::createWidget().

Véase también QToolButton, QMenu y QAction.

Documentación de propiedades

allowedAreas : Qt::ToolBarAreas

zonas en las que se puede colocar la barra de herramientas

El valor predeterminado es Qt::AllToolBarAreas.

Esta propiedad solo tiene sentido si la barra de herramientas se encuentra en un QMainWindow.

Funciones de acceso:

Qt::ToolBarAreas allowedAreas() const
void setAllowedAreas(Qt::ToolBarAreas areas)

Señal de notificación:

void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

Véase también movable.

floatable : bool

Esta propiedad determina si la barra de herramientas se puede arrastrar y soltar como una ventana independiente.

El valor predeterminado es «true».

Funciones de acceso:

bool isFloatable() const
void setFloatable(bool floatable)

[read-only] floating : bool

Esta propiedad indica si la barra de herramientas es una ventana independiente.

Por defecto, esta propiedad tiene el valor « true ».

Funciones de acceso:

bool isFloating() const

Véase también QWidget::isWindow().

iconSize : QSize

tamaño de los iconos de la barra de herramientas.

El tamaño predeterminado viene determinado por el estilo de la aplicación y se deriva de la métrica de píxeles « QStyle::PM_ToolBarIconSize ». Es el tamaño máximo que puede tener un icono. Los iconos de menor tamaño no se ampliarán.

Funciones de acceso:

QSize iconSize() const
void setIconSize(const QSize &iconSize)

Señal de notificador:

void iconSizeChanged(const QSize &iconSize)

movable : bool

Esta propiedad determina si el usuario puede mover la barra de herramientas dentro de su área o entre diferentes áreas de la barra de herramientas.

El valor por defecto depende del estilo (viene determinado por la indicación de estilo « QStyle::SH_ToolBar_Movable ») y, para la mayoría de los estilos, es « true ».

Esta propiedad solo tiene sentido si la barra de herramientas se encuentra en un QMainWindow.

Funciones de acceso:

bool isMovable() const
void setMovable(bool movable)

Señal del notificador:

void movableChanged(bool movable)

Véase también ` allowedAreas`.

orientation : Qt::Orientation

Orientación de la barra de herramientas

El valor por defecto es ` Qt::Horizontal`.

Esta función no debe utilizarse cuando la barra de herramientas se gestiona mediante QMainWindow. Puedes utilizar QMainWindow::addToolBar() o QMainWindow::insertToolBar() si deseas mover una barra de herramientas que ya está añadida a una ventana principal a otra Qt::ToolBarArea.

Funciones de acceso:

Qt::Orientation orientation() const
void setOrientation(Qt::Orientation orientation)

Señal de notificación:

void orientationChanged(Qt::Orientation orientation)

toolButtonStyle : Qt::ToolButtonStyle

Esta propiedad define el estilo de los botones de la barra de herramientas

Esta propiedad define el estilo de todos los botones de herramientas que se añaden como objetos de tipo « QAction». Ten en cuenta que si añades un objeto « QToolButton » con el método « addWidget()», este no adoptará este estilo de botón.

Para que el estilo de los botones de herramientas siga la configuración del sistema, establezca esta propiedad en « Qt::ToolButtonFollowStyle ». En Unix, se utilizarán los ajustes de usuario del entorno de escritorio. En otras plataformas, « Qt::ToolButtonFollowStyle » significa «solo icono».

El valor por defecto es Qt::ToolButtonIconOnly.

Funciones de acceso:

Qt::ToolButtonStyle toolButtonStyle() const
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

Señal del notificador:

void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

Documentación de las funciones de miembro

[explicit] QToolBar::QToolBar(QWidget *parent = nullptr)

Crea una barra de herramientas (QToolBar) con el parent especificado.

[explicit] QToolBar::QToolBar(const QString &title, QWidget *parent = nullptr)

Crea una barra de herramientas QToolBar con el parent especificado.

El title de la ventana especificado identifica la barra de herramientas y aparece en el menú contextual proporcionado por QMainWindow.

Véase también setWindowTitle().

[virtual noexcept] QToolBar::~QToolBar()

Elimina la barra de herramientas.

QAction *QToolBar::actionAt(const QPoint &p) const

Devuelve la acción en el punto p. Esta función devuelve cero si no se ha encontrado ninguna acción.

Véase también QWidget::childAt().

QAction *QToolBar::actionAt(int x, int y) const

Devuelve la acción en el punto x, y. Esta función devuelve cero si no se ha encontrado ninguna acción.

Se trata de una función sobrecargada.

[override virtual protected] void QToolBar::actionEvent(QActionEvent *event)

Reimplementa: QWidget::actionEvent(QActionEvent *event).

[signal] void QToolBar::actionTriggered(QAction *action)

Esta señal se emite cuando se activa una acción de esta barra de herramientas. Esto ocurre al pulsar el botón de la herramienta correspondiente a dicha acción o cuando la acción se activa de alguna otra forma fuera de la barra de herramientas. El parámetro contiene el evento activado: ` action`.

QAction *QToolBar::addSeparator()

Añade un separador al final de la barra de herramientas.

Véase también insertSeparator().

QAction *QToolBar::addWidget(QWidget *widget)

Añade el elemento « widget » especificado a la barra de herramientas como último elemento de la misma.

La barra de herramientas asume la propiedad de widget.

Si añades un « QToolButton » con este método, no se respetará la propiedad « Qt::ToolButtonStyle » de la barra de herramientas.

Nota: Debes utilizar ` QAction::setVisible()` para cambiar la visibilidad del widget. El uso de ` QWidget::setVisible()`, ` QWidget::show()` y ` QWidget::hide()` no funciona.

Véase también insertWidget().

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

Esta señal se emite cuando se modifica el conjunto de áreas permitidas para la barra de herramientas. Las nuevas áreas en las que se puede colocar la barra de herramientas se especifican mediante allowedAreas.

Nota: Señalde notificación para la propiedad allowedAreas.

Véase también ` allowedAreas`.

[override virtual protected] void QToolBar::changeEvent(QEvent *event)

Reimplementa: ` QWidget::changeEvent(QEvent *event)`.

void QToolBar::clear()

Elimina todas las acciones de la barra de herramientas.

Véase también removeAction().

[override virtual protected] bool QToolBar::event(QEvent *event)

Reimplementa: QWidget::event(QEvent *event).

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

Esta señal se emite cuando se modifica el tamaño del icono. El parámetro iconSize contiene el nuevo tamaño del icono de la barra de herramientas.

Nota: Señalde notificación para la propiedad iconSize.

Véase también « iconSize » y « QMainWindow::iconSize ».

QAction *QToolBar::insertSeparator(QAction *before)

Inserta un separador en la barra de herramientas, delante del elemento de la barra de herramientas asociado a la acción « before ».

Véase también addSeparator().

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

Inserta el « widget » indicado delante del elemento de la barra de herramientas asociado a la acción « before ».

Nota: Debes utilizar QAction::setVisible() para cambiar la visibilidad del widget. El uso de QWidget::setVisible(), QWidget::show() y QWidget::hide() no funciona.

Véase también addWidget().

bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const

Devuelve ` true ` si esta barra de herramientas se puede acoplar en el ` area` indicado; en caso contrario, devuelve ` false`.

[signal] void QToolBar::movableChanged(bool movable)

Esta señal se emite cuando la barra de herramientas pasa a ser desplazable o fija. Si la barra de herramientas se puede desplazar, movable es verdadero; en caso contrario, es falso.

Nota: Señalde notificación para la propiedad movable.

Véase también movable.

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

Esta señal se emite cuando cambia la orientación de la barra de herramientas. El parámetro « orientation » contiene la nueva orientación de la barra de herramientas.

Nota: Señalde notificación para la propiedad orientation.

Véase también ` orientation`.

[override virtual protected] void QToolBar::paintEvent(QPaintEvent *event)

Reimplementa: QWidget::paintEvent(QPaintEvent *event).

QAction *QToolBar::toggleViewAction() const

Devuelve una acción que se puede marcar y que sirve para mostrar u ocultar esta barra de herramientas.

El texto de la acción se establece como el título de la ventana de la barra de herramientas.

Véase también QAction::text y QWidget::windowTitle.

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

Esta señal se emite cuando se cambia el estilo de un botón de herramienta. El parámetro ` toolButtonStyle ` contiene el nuevo estilo del botón de herramienta de la barra de herramientas.

Nota: Señalde notificación para la propiedad toolButtonStyle.

Véase también « toolButtonStyle » y « QMainWindow::toolButtonStyle ».

[signal] void QToolBar::topLevelChanged(bool topLevel)

Esta señal se emite cuando cambia la propiedad « floating ». El parámetro « topLevel » es «true» si la barra de herramientas está ahora flotante; en caso contrario, es «false».

Véase también isWindow().

[signal] void QToolBar::visibilityChanged(bool visible)

Esta señal se emite cuando la barra de herramientas pasa a estar « visible » (o invisible). Esto ocurre cuando se oculta o se muestra el widget.

QWidget *QToolBar::widgetForAction(QAction *action) const

Devuelve el widget asociado al ` action` especificado.

Véase también addWidget().

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