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
- count : int
- currentIndex : int
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) |
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.