En esta página

QToolBox Class

La clase QToolBox proporciona una columna de elementos de widget con pestañas. Más información...

Encabezado: #include <QToolBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QFrame

Propiedades

Funciones públicas

QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
virtual ~QToolBox()
int addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
int addItem(QWidget *w, const QString &text)
int count() const
int currentIndex() const
QWidget *currentWidget() const
int indexOf(const QWidget *widget) const
int insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)
int insertItem(int index, QWidget *widget, const QString &text)
bool isItemEnabled(int index) const
QIcon itemIcon(int index) const
QString itemText(int index) const
QString itemToolTip(int index) const
void removeItem(int index)
void setItemEnabled(int index, bool enabled)
void setItemIcon(int index, const QIcon &icon)
void setItemText(int index, const QString &text)
void setItemToolTip(int index, const QString &toolTip)
QWidget *widget(int index) const

Ranuras públicas

void setCurrentIndex(int index)
void setCurrentWidget(QWidget *widget)

Señales

void currentChanged(int index)

Funciones protegidas

virtual void itemInserted(int index)
virtual void itemRemoved(int index)

Funciones protegidas reimplementadas

virtual void changeEvent(QEvent *ev) override
virtual bool event(QEvent *e) override
virtual void showEvent(QShowEvent *e) override

Descripción detallada

Una caja de herramientas es un widget que muestra una columna de pestañas una encima de otra, con el elemento actual mostrado debajo de la pestaña correspondiente. Cada pestaña tiene una posición de índice dentro de la columna de pestañas. El elemento de una pestaña es un ` QWidget`.

Cada elemento tiene un ` itemText()`, un ` itemIcon()` opcional, un ` itemToolTip()` opcional y un ` widget()`. Los atributos del elemento se pueden modificar con ` setItemText()`, ` setItemIcon()` y ` setItemToolTip()`. Cada elemento se puede activar o desactivar individualmente con ` setItemEnabled()`.

Los elementos se añaden mediante addItem(), o se insertan en posiciones concretas mediante insertItem(). El número total de elementos se obtiene mediante count(). Los elementos se pueden eliminar con delete, o retirarlos de la caja de herramientas con removeItem(). La combinación de removeItem() y insertItem() permite mover elementos a diferentes posiciones.

El índice del widget del elemento actual se obtiene mediante currentIndex(), y se establece con setCurrentIndex(). El índice de un elemento concreto se puede averiguar utilizando indexOf(), y el elemento situado en un índice determinado se obtiene mediante item().

La señal currentChanged() se emite cuando se modifica el elemento actual.

Véase también QTabWidget.

Documentación de propiedades

[read-only] count : int

Esta propiedad indica el número de elementos que contiene la caja de herramientas.

Por defecto, esta propiedad tiene un valor de 0.

Funciones de acceso:

int count() const

currentIndex : int

Esta propiedad contiene el índice del elemento actual

Por defecto, para una caja de herramientas vacía, esta propiedad tiene un valor de -1.

Funciones de acceso:

int currentIndex() const
void setCurrentIndex(int index)

Señal de notificación:

void currentChanged(int index)

Véase también indexOf() y widget().

Documentación de las funciones de miembro

[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crea una nueva caja de herramientas con el « parent » especificado y los indicadores « f ».

[virtual noexcept] QToolBox::~QToolBox()

Destruye la caja de herramientas.

int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)

Añade el « widget » en una nueva pestaña situada en la parte inferior de la caja de herramientas. El texto de la nueva pestaña se establece como « text », y el « iconSet » se muestra a la izquierda del « text ». Devuelve el índice de la nueva pestaña.

int QToolBox::addItem(QWidget *w, const QString &text)

Añade el widget « w » en una nueva pestaña situada en la parte inferior de la caja de herramientas. El texto de la nueva pestaña se establece como « text ». Devuelve el índice de la nueva pestaña.

Esta es una función sobrecargada.

[override virtual protected] void QToolBox::changeEvent(QEvent *ev)

Reimplementa: QFrame::changeEvent(QEvent *ev).

[signal] void QToolBox::currentChanged(int index)

Esta señal se emite cuando cambia el elemento actual. Se pasa el índice del nuevo elemento actual en ` index`, o -1 si no hay ningún elemento actual.

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

QWidget *QToolBox::currentWidget() const

Devuelve un puntero al widget actual o ` nullptr ` si no existe dicho elemento.

Véase también currentIndex() y setCurrentWidget().

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

Reimplementa: QFrame::event(QEvent *e).

int QToolBox::indexOf(const QWidget *widget) const

Devuelve el índice de widget, o -1 si el elemento no existe.

int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)

Inserta el elemento « widget » en la posición index, o en la parte inferior de la caja de herramientas si index está fuera de rango. El texto del nuevo elemento se establece en text, y el icon se muestra a la izquierda del text. Devuelve el índice del nuevo elemento.

int QToolBox::insertItem(int index, QWidget *widget, const QString &text)

Inserta el elemento « widget » en la posición index, o en la parte inferior de la caja de herramientas si index está fuera de rango. El texto del nuevo elemento se establece en text. Devuelve el índice del nuevo elemento.

Se trata de una función sobrecargada.

bool QToolBox::isItemEnabled(int index) const

Devuelve ` true ` si el elemento situado en la posición ` index ` está habilitado; en caso contrario, devuelve ` false`.

QIcon QToolBox::itemIcon(int index) const

Devuelve el icono del elemento situado en la posición index, o un icono nulo si index está fuera de rango.

Véase también setItemIcon().

[virtual protected] void QToolBox::itemInserted(int index)

Este controlador virtual se ejecuta después de que se haya añadido o insertado un nuevo elemento en la posición index.

Véase también itemRemoved().

[virtual protected] void QToolBox::itemRemoved(int index)

Este controlador virtual se activa después de que se haya eliminado un elemento de la posición index.

Véase también itemInserted().

QString QToolBox::itemText(int index) const

Devuelve el texto del elemento situado en la posición index, o una cadena vacía si index está fuera de rango.

Véase también setItemText().

QString QToolBox::itemToolTip(int index) const

Devuelve la descripción emergente del elemento situado en la posición index, o una cadena vacía si index está fuera de rango.

Véase también setItemToolTip().

void QToolBox::removeItem(int index)

Elimina el elemento situado en la posición index de la caja de herramientas. Ten en cuenta que el widget no se elimina.

[slot] void QToolBox::setCurrentWidget(QWidget *widget)

Establecewidget como el widget actual. El widget debe ser un elemento de esta caja de herramientas.

Véase también addItem(), setCurrentIndex() y currentWidget().

void QToolBox::setItemEnabled(int index, bool enabled)

Si enabled es verdadero, el elemento situado en la posición index está activado; en caso contrario, el elemento situado en la posición index está desactivado.

Véase también isItemEnabled().

void QToolBox::setItemIcon(int index, const QIcon &icon)

Establece el icono del elemento situado en la posición index como icon.

Véase también itemIcon().

void QToolBox::setItemText(int index, const QString &text)

Establece el texto del elemento situado en la posición index en text.

Si el texto proporcionado contiene un carácter «&» (símbolo «&»), se crea automáticamente un atajo de teclado para él. El carácter que siga al «&» se utilizará como tecla de atajo. Cualquier atajo de teclado anterior se sobrescribirá, o se borrará si el texto no define ningún atajo. Consulte la documentación de QShortcut para obtener más detalles (para mostrar un símbolo «&» real, utilice «&&»).

Véase también itemText().

void QToolBox::setItemToolTip(int index, const QString &toolTip)

Establece la descripción emergente del elemento situado en la posición index en toolTip.

Véase también itemToolTip().

[override virtual protected] void QToolBox::showEvent(QShowEvent *e)

Reimplementa: ` QWidget::showEvent(QShowEvent *event)`.

QWidget *QToolBox::widget(int index) const

Devuelve el widget situado en la posición index, o nullptr si no existe dicho elemento.

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