Back to Qt.io
Contact Us Blog Download Qt
En esta página

QToolBar Class

La clase QToolBar proporciona un panel móvil que contiene un conjunto de controles. Más...

Cabecera: #include <QToolBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: 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

Una barra de herramientas se crea típicamente llamando a QMainWindow::addToolBar(const QString &title), pero también puede añadirse como el 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 pueden separarse mediante addSeparator() o insertSeparator(). Si un botón de la barra de herramientas no es apropiado, 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, se emite la señal actionTriggered().

Una barra de herramientas puede estar fija en un área determinada (por ejemplo, en la parte superior de la ventana), o puede moverse entre áreas de la barra de herramientas; véase setMovable(), isMovable(), allowedAreas() y isAreaAllowed().

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

Cuando una QToolBar no es hija de QMainWindow, pierde la capacidad de rellenar la extensión emergente con widgets añadidos a la barra de herramientas usando addWidget(). Por favor, utilice acciones widget creadas heredando QWidgetAction e implementando QWidgetAction::createWidget() en su lugar.

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 por defecto es Qt::AllToolBarAreas.

Esta propiedad sólo tiene sentido si la barra de herramientas está en QMainWindow.

Funciones de acceso:

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

Señal de notificador:

void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

Véase también movable.

floatable : bool

Esta propiedad indica si la barra de herramientas puede arrastrarse y soltarse como una ventana independiente.

Por defecto 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 es 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 por defecto 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 escalarán.

Funciones de acceso:

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

Señal de aviso:

void iconSizeChanged(const QSize &iconSize)

movable : bool

Esta propiedad establece si el usuario puede mover la barra de herramientas dentro del área de la barra de herramientas, o entre áreas de la barra de herramientas.

Por defecto, esta propiedad es true.

Esta propiedad sólo tiene sentido si la barra de herramientas está en QMainWindow.

Funciones de acceso:

bool isMovable() const
void setMovable(bool movable)

Señal de 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 está gestionada por QMainWindow. Puede utilizar QMainWindow::addToolBar() o QMainWindow::insertToolBar() si desea mover una barra de herramientas ya 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 notificador:

void orientationChanged(Qt::Orientation orientation)

toolButtonStyle : Qt::ToolButtonStyle

Esta propiedad contiene 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 QActions. Tenga en cuenta que si añade un QToolButton con el método addWidget(), no obtendrá este estilo de botón.

Para que el estilo de los botones de herramientas siga la configuración del sistema, establezca esta propiedad a Qt::ToolButtonFollowStyle. En Unix, se utilizará la configuración de usuario del entorno de escritorio. En otras plataformas, Qt::ToolButtonFollowStyle significa sólo 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 la función miembro

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

Construye una QToolBar con la dirección parent.

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

Construye una QToolBar con la dirección parent.

La ventana dada title identifica la barra de herramientas y se muestra en el menú contextual proporcionado por QMainWindow.

Ver también setWindowTitle().

[virtual noexcept] QToolBar::~QToolBar()

Destruye 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 en esta barra de herramientas. Esto ocurre cuando se pulsa el botón de la herramienta de la 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 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 la dirección widget a la barra de herramientas como último elemento.

La barra de herramientas se apropia de widget.

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

Nota: Debes utilizar QAction::setVisible() para cambiar la visibilidad del widget. Utilizar 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 cambia la colección de áreas permitidas para la barra de herramientas. Las nuevas áreas en las que se puede posicionar la barra de herramientas se especifican en allowedAreas.

Nota: Señal notificadora de 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 cambia el tamaño del icono. El parámetro iconSize contiene el nuevo tamaño del icono de la barra de herramientas.

Nota: Señal notificadora 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 dado delante del elemento de la barra de herramientas asociado a la acción before.

Nota: Debe utilizar QAction::setVisible() para cambiar la visibilidad del widget. Utilizar 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 es acoplable en el area dado ; en caso contrario devuelve false.

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

Esta señal se emite cuando la barra de herramientas se vuelve movible o fija. Si la barra de herramientas se puede mover, movable es verdadero; en caso contrario es falso.

Nota: Señal notificadora de 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ñal notificadora de 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 comprobable que se puede utilizar para mostrar u ocultar esta barra de herramientas.

El texto de la acción se establece en 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 del botón de herramienta. El parámetro toolButtonStyle contiene el nuevo estilo del botón de herramienta de la barra de herramientas.

Nota: Señal notificadora 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 verdadero si la barra de herramientas es ahora flotante; en caso contrario es falso.

Véase también isWindow().

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

Esta señal se emite cuando la barra de herramientas se vuelve visible (o invisible). Esto ocurre cuando el widget se oculta o se muestra.

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

Devuelve el widget asociado a la dirección action especificada.

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.