QToolBox Class
La classe QToolBox fournit une colonne de widgets sous forme d'onglets. En savoir plus...
| En-tête : | #include <QToolBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | 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 actif s'affichant sous l'onglet actif. Chaque onglet possède une position d'index au sein de la colonne d'onglets. L'élément d'un onglet est une instance de ` QWidget`.
Chaque élément dispose d’une méthode ` itemText()`, d’une méthode facultative ` itemIcon()`, d’une méthode facultative ` itemToolTip()` et d’une méthode ` widget()`. Les attributs de l’élément peuvent être modifiés à l’aide des méthodes ` setItemText()`, ` setItemIcon()` et ` setItemToolTip()`. Chaque élément peut être activé ou désactivé individuellement à l’aide de la méthode ` setItemEnabled()`.
Les éléments sont ajoutés à l’aide de ` addItem()` ou insérés à des positions spécifiques à l’aide de ` insertItem()`. Le nombre total d’éléments est fourni par ` count()`. Les éléments peuvent être supprimés à l’aide de `delete`, ou retirés de la boîte à outils à l’aide de ` removeItem()`. La combinaison de ` removeItem()` et ` insertItem()` permet de déplacer les éléments vers différentes positions.
L’index du widget de l’élément actuel est renvoyé par currentIndex(), et défini avec setCurrentIndex(). L’index d’un élément particulier peut être obtenu à l’aide de indexOf(), et l’élément situé à un index donné est renvoyé par item().
Le signal currentChanged() est émis lorsque l’élément actuel est modifié.
Voir aussi 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 la valeur 0.
Fonctions d'accès :
| int | count() const |
currentIndex : int
Cette propriété contient l'index de l'élément actuel
Par défaut, lorsque la boîte à outils est vide, cette propriété a pour valeur -1.
Fonctions d'accès :
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Signal de notification :
| void | currentChanged(int index) |
Documentation des fonctions membres
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Crée une nouvelle boîte à outils avec l'parent ion fournie et les indicateurs suivants : f.
[virtual noexcept] QToolBox::~QToolBox()
Détruit la boîte à outils.
int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
Ajoute l'widget e dans un nouvel onglet situé au bas de la boîte à outils. Le texte du nouvel onglet est défini sur « text », et l'iconSet e s'affiche à gauche de l'text e. Renvoie l'index du nouvel onglet.
int QToolBox::addItem(QWidget *w, const QString &text)
Ajoute le widget « w » dans un nouvel onglet situé au bas de la boîte à outils. Le texte de ce nouvel onglet est défini sur « 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 actif est modifié. L'index du nouvel élément actif est transmis dans ` index`, ou -1 s'il n'y a pas d'élément actif.
Remarque : signalde notification pour la propriété currentIndex.
QWidget *QToolBox::currentWidget() const
Renvoie un pointeur vers le widget actuel, ou ` nullptr ` si aucun élément de ce type n'existe.
Voir également 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 d'un élément de la collection ` 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 l'élément « widget » à la position index, ou au bas de la boîte à outils si index est hors de la plage autorisée. Le texte du nouvel élément est défini sur text, et l'élément « icon » s'affiche à gauche de l'élément « text ». Renvoie l'index du nouvel élément.
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
Insère l'élément « widget » à la position index, ou au bas de la boîte à outils si index est hors limites. Le texte du nouvel élément est défini sur 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 situé à la position index, ou une icône nulle si index est hors limites.
Voir également setItemIcon().
[virtual protected] void QToolBox::itemInserted(int index)
Ce gestionnaire virtuel est appelé lorsqu'un nouvel élément a été ajouté ou inséré à la position index.
Voir également itemRemoved().
[virtual protected] void QToolBox::itemRemoved(int index)
Ce gestionnaire virtuel est appelé lorsqu'un élément a été supprimé de la position index.
Voir également itemInserted().
QString QToolBox::itemText(int index) const
Renvoie le texte de l'élément situé à la position index, ou une chaîne vide si index est hors de la plage autorisée.
Voir aussi setItemText().
QString QToolBox::itemToolTip(int index) const
Renvoie l'info-bulle de l'élément situé à la position index, ou une chaîne vide si index se trouve hors de la plage autorisé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)
Définitwidget comme widget actif. L'widget e doit être un élément de cette boîte à outils.
Voir également addItem(), setCurrentIndex() et currentWidget().
void QToolBox::setItemEnabled(int index, bool enabled)
Si enabled est vrai, l'élément situé à la position index est activé ; dans le cas contraire, 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 situé à la position index sur icon.
Voir également itemIcon().
void QToolBox::setItemText(int index, const QString &text)
Définit le texte de l'élément situé à la position index sur text.
Si le texte fourni contient le caractère « & » (esperluette), un mnémonique est automatiquement créé pour celui-ci. Le caractère suivant 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. Consultez la documentation de QShortcut pour plus de détails (pour afficher un « et commercial » réel, utilisez « && »).
Voir également itemText().
void QToolBox::setItemToolTip(int index, const QString &toolTip)
Définit l'info-bulle de l'élément situé à la position index sur toolTip.
Voir également 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 situé à la position index, ou nullptr s'il n'existe aucun élément correspondant.
© 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.
