QToolBox Class
La classe QToolBox fournit une colonne d'éléments de widgets à onglets. Plus d'informations...
| En-tête : | #include <QToolBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QFrame |
Propriétés
- count : int
- currentIndex : int
Fonctions publiques
| 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 |
Emplacements publics
| void | setCurrentIndex(int index) |
| void | setCurrentWidget(QWidget *widget) |
Signaux
| void | currentChanged(int index) |
Fonctions protégées
| virtual void | itemInserted(int index) |
| virtual void | itemRemoved(int index) |
Fonctions protégées réimplémentées
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | showEvent(QShowEvent *e) override |
Description détaillée
Une boîte à outils est un widget qui affiche une colonne d'onglets les uns au-dessus des autres, l'élément courant étant affiché sous l'onglet courant. Chaque onglet a une position d'index dans la colonne d'onglets. L'élément d'un onglet est un QWidget.
Chaque élément possède un itemText(), un itemIcon() facultatif, un itemToolTip() facultatif et un widget(). Les attributs de l'élément peuvent être modifiés avec setItemText(), setItemIcon() et setItemToolTip(). Chaque élément peut être activé ou désactivé individuellement avec setItemEnabled().
Les éléments sont ajoutés à l'aide de addItem(), ou insérés à des positions particulières à l'aide de insertItem(). Le nombre total d'éléments est donné par count(). Les éléments peuvent être supprimés avec delete, ou retirés de la boîte à outils avec removeItem(). La combinaison de removeItem() et insertItem() permet de déplacer les éléments à différentes positions.
L'index du widget de l'élément courant est renvoyé par currentIndex() et défini par setCurrentIndex(). L'index d'un élément particulier peut être trouvé en utilisant indexOf(), et l'élément à un index donné est renvoyé par item().
Le signal currentChanged() est émis lorsque l'élément en cours est modifié.
Voir également QTabWidget.
Documentation sur les propriétés
[read-only] count : int
Cette propriété indique le nombre d'éléments contenus dans la boîte à outils.
Par défaut, cette propriété a une valeur de 0.
Fonctions d'accès :
| int | count() const |
currentIndex : int
Cette propriété contient l'index de l'élément courant
Par défaut, pour une boîte à outils vide, cette propriété a une valeur de -1.
Fonctions d'accès :
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Signal Notifier :
| void | currentChanged(int index) |
Documentation des fonctions membres
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Construit une nouvelle boîte à outils avec l'adresse parent et les drapeaux f.
[virtual noexcept] QToolBox::~QToolBox()
Détruit la boîte à outils.
int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
Ajoute le site widget dans un nouvel onglet au bas de la boîte à outils. Le texte du nouvel onglet est text, et le iconSet est affiché à gauche du text. Renvoie l'index du nouvel onglet.
int QToolBox::addItem(QWidget *w, const QString &text)
Ajoute le widget w dans un nouvel onglet au bas de la boîte à outils. Le texte du nouvel onglet est fixé à text. Renvoie l'index du nouvel onglet.
Il s'agit d'une fonction surchargée.
[override virtual protected] void QToolBox::changeEvent(QEvent *ev)
Réimplémente : QFrame::changeEvent(QEvent *ev).
[signal] void QToolBox::currentChanged(int index)
Ce signal est émis lorsque l'élément courant est modifié. L'index du nouvel élément courant est transmis dans index, ou -1 s'il n'y a pas d'élément courant.
Note : Signal de notification pour la propriété currentIndex.
QWidget *QToolBox::currentWidget() const
Renvoie un pointeur sur le widget actuel, ou nullptr s'il n'existe pas d'élément de ce type.
Voir aussi currentIndex() et setCurrentWidget().
[override virtual protected] bool QToolBox::event(QEvent *e)
Réimplémente : QFrame::event(QEvent *e).
int QToolBox::indexOf(const QWidget *widget) const
Renvoie l'index de widget, ou -1 si l'élément n'existe pas.
int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)
Insère le widget à la position index, ou au bas de la boîte à outils si index est hors de portée. Le texte du nouvel élément est fixé à text, et le icon est affiché à gauche du text. Renvoie l'index du nouvel élément.
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
Insère l'article widget à la position index, ou au bas de la boîte à outils si index est hors de portée. Le texte du nouvel élément est fixé à text. Renvoie l'index du nouvel élément.
Il s'agit d'une fonction surchargée.
bool QToolBox::isItemEnabled(int index) const
Renvoie true si l'élément situé à la position index est activé ; sinon, renvoie false.
QIcon QToolBox::itemIcon(int index) const
Renvoie l'icône de l'élément à la position index, ou une icône nulle si index est hors de portée.
Voir aussi setItemIcon().
[virtual protected] void QToolBox::itemInserted(int index)
Ce gestionnaire virtuel est appelé après l'ajout ou l'insertion d'un nouvel élément à la position index.
Voir aussi itemRemoved().
[virtual protected] void QToolBox::itemRemoved(int index)
Ce gestionnaire virtuel est appelé après qu'un élément a été retiré de la position index.
Voir aussi itemInserted().
QString QToolBox::itemText(int index) const
Renvoie le texte de l'élément à la position index, ou une chaîne vide si index est hors de portée.
Voir aussi setItemText().
QString QToolBox::itemToolTip(int index) const
Renvoie l'infobulle de l'élément situé à la position index, ou une chaîne vide si index est hors de portée.
Voir aussi setItemToolTip().
void QToolBox::removeItem(int index)
Supprime de la boîte à outils l'élément situé à la position index. Notez que le widget n' est pas supprimé.
[slot] void QToolBox::setCurrentWidget(QWidget *widget)
Fait dewidget le widget actuel. Le widget doit être un élément de cette boîte à outils.
Voir aussi addItem(), setCurrentIndex() et currentWidget().
void QToolBox::setItemEnabled(int index, bool enabled)
Si enabled est vrai, l'élément situé à la position index est activé ; sinon, l'élément situé à la position index est désactivé.
Voir également isItemEnabled().
void QToolBox::setItemIcon(int index, const QIcon &icon)
Définit l'icône de l'élément à la position index à icon.
Voir aussi itemIcon().
void QToolBox::setItemText(int index, const QString &text)
Définit le texte de l'élément à la position index à text.
Si le texte fourni contient une esperluette ('&'), un mnémonique est automatiquement créé. Le caractère qui suit le "&" sera utilisé comme touche de raccourci. Tout mnémonique précédent sera écrasé, ou effacé si aucun mnémonique n'est défini par le texte. Voir la documentation de QShortcut pour plus de détails (pour afficher une esperluette, utiliser '&&').
Voir aussi itemText().
void QToolBox::setItemToolTip(int index, const QString &toolTip)
Définit l'infobulle de l'élément à la position index à toolTip.
Voir aussi itemToolTip().
[override virtual protected] void QToolBox::showEvent(QShowEvent *e)
Réimplémente : QWidget::showEvent(QShowEvent *event).
QWidget *QToolBox::widget(int index) const
Renvoie le widget à la position index, ou nullptr s'il n'existe pas d'élément de ce type.
© 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.
