QToolBox Class
La clase QToolBox proporciona una columna de elementos de widget con pestañas. Más...
| Cabecera: | #include <QToolBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 actual. Cada pestaña tiene una posición de índice dentro de la columna de pestañas. El elemento de una pestaña es QWidget.
Cada elemento tiene un itemText(), un itemIcon() opcional, un itemToolTip() opcional, y un widget(). Los atributos del elemento pueden modificarse con setItemText(), setItemIcon() y setItemToolTip(). Cada elemento puede activarse o desactivarse individualmente con setItemEnabled().
Los elementos se añaden con addItem(), o se insertan en posiciones concretas con insertItem(). El número total de elementos viene dado por count(). Los elementos pueden borrarse con delete, o eliminarse 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 devuelve con currentIndex(), y se establece con setCurrentIndex(). El índice de un elemento en particular se puede encontrar utilizando indexOf(), y el elemento en un índice dado es devuelto por item().
La señal currentChanged() se emite cuando se cambia el elemento actual.
Véase también QTabWidget.
Documentación de propiedades
[read-only] count : int
Esta propiedad contiene 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 del notificador:
| void | currentChanged(int index) |
Documentación de las funciones miembro
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Construye una nueva caja de herramientas con el parent dado y las banderas, f.
[virtual noexcept] QToolBox::~QToolBox()
Destruye la caja de herramientas.
int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
Añade widget en una nueva pestaña en la parte inferior de la caja de herramientas. El texto de la nueva pestaña se establece en text, y iconSet se muestra a la izquierda de 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 en la parte inferior de la caja de herramientas. El texto de la nueva pestaña es 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 se cambia el elemento actual. El índice del nuevo elemento actual se pasa en index, o -1 si no hay elemento actual.
Nota: Señal notificadora para la propiedad currentIndex.
QWidget *QToolBox::currentWidget() const
Devuelve un puntero al widget actual, o nullptr si no existe tal 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 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 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 en la posición index está habilitado; en caso contrario devuelve false.
QIcon QToolBox::itemIcon(int index) const
Devuelve el icono del elemento 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 manejador virtual es llamado después de que un nuevo elemento fue añadido o insertado en la posición index.
Véase también itemRemoved().
[virtual protected] void QToolBox::itemRemoved(int index)
Este manejador virtual es llamado después de que un ítem fue removido de la posición index.
Véase también itemInserted().
QString QToolBox::itemText(int index) const
Devuelve el texto del elemento 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 el tooltip del elemento 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. Tenga en cuenta que el widget no se elimina.
[slot] void QToolBox::setCurrentWidget(QWidget *widget)
Hace quewidget sea el widget actual. 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, se activa el elemento en la posición index; en caso contrario, se desactiva el elemento en la posición index.
Véase también isItemEnabled().
void QToolBox::setItemIcon(int index, const QIcon &icon)
Establece el icono del elemento en la posición index a icon.
Véase también itemIcon().
void QToolBox::setItemText(int index, const QString &text)
Establece el texto del elemento en la posición index en text.
Si el texto proporcionado contiene un carácter ampersand ('&'), se creará automáticamente un mnemotécnico para él. El carácter que sigue al '&' se utilizará como tecla de acceso directo. Cualquier mnemotecnia anterior se sobrescribirá, o se borrará si el texto no ha definido ninguna mnemotecnia. Consulte la documentación de QShortcut para más detalles (para mostrar un ampersand real, utilice '&&').
Véase también itemText().
void QToolBox::setItemToolTip(int index, const QString &toolTip)
Establece la información sobre herramientas del elemento en la posición index a 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 en la posición index, o nullptr si no existe tal 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.
