QTabBar Class
La classe QTabBar permet de créer une barre d'onglets, notamment pour une utilisation dans des boîtes de dialogue à onglets. En savoir plus...
| En-tête : | #include <QTabBar> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QWidget |
Types publics
| enum | ButtonPosition { LeftSide, RightSide } |
| enum | SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab } |
| enum | Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, TriangularNorth, …, TriangularEast } |
Propriétés
|
|
Fonctions publiques
| QTabBar(QWidget *parent = nullptr) | |
| virtual | ~QTabBar() |
| QString | accessibleTabName(int index) const |
| int | addTab(const QString &text) |
| int | addTab(const QIcon &icon, const QString &text) |
| bool | autoHide() const |
| bool | changeCurrentOnDrag() const |
| int | count() const |
| int | currentIndex() const |
| bool | documentMode() const |
| bool | drawBase() const |
| Qt::TextElideMode | elideMode() const |
| bool | expanding() const |
| QSize | iconSize() const |
| int | insertTab(int index, const QString &text) |
| int | insertTab(int index, const QIcon &icon, const QString &text) |
| bool | isMovable() const |
| bool | isTabEnabled(int index) const |
| bool | isTabVisible(int index) const |
| void | moveTab(int from, int to) |
| void | removeTab(int index) |
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setAccessibleTabName(int index, const QString &name) |
| void | setAutoHide(bool hide) |
| void | setChangeCurrentOnDrag(bool change) |
| void | setDocumentMode(bool set) |
| void | setDrawBase(bool drawTheBase) |
| void | setElideMode(Qt::TextElideMode mode) |
| void | setExpanding(bool enabled) |
| void | setIconSize(const QSize &size) |
| void | setMovable(bool movable) |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
| void | setShape(QTabBar::Shape shape) |
| void | setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget) |
| void | setTabData(int index, const QVariant &data) |
| void | setTabEnabled(int index, bool enabled) |
| void | setTabIcon(int index, const QIcon &icon) |
| void | setTabText(int index, const QString &text) |
| void | setTabTextColor(int index, const QColor &color) |
| void | setTabToolTip(int index, const QString &tip) |
| void | setTabVisible(int index, bool visible) |
| void | setTabWhatsThis(int index, const QString &text) |
| void | setTabsClosable(bool closable) |
| void | setUsesScrollButtons(bool useButtons) |
| QTabBar::Shape | shape() const |
| int | tabAt(const QPoint &position) const |
| QWidget * | tabButton(int index, QTabBar::ButtonPosition position) const |
| QVariant | tabData(int index) const |
| QIcon | tabIcon(int index) const |
| QRect | tabRect(int index) const |
| QString | tabText(int index) const |
| QColor | tabTextColor(int index) const |
| QString | tabToolTip(int index) const |
| QString | tabWhatsThis(int index) const |
| bool | tabsClosable() const |
| bool | usesScrollButtons() const |
Fonctions publiques réimplémentées
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Slots publics
| void | setCurrentIndex(int index) |
Signaux
| void | currentChanged(int index) |
| void | tabBarClicked(int index) |
| void | tabBarDoubleClicked(int index) |
| void | tabCloseRequested(int index) |
| void | tabMoved(int from, int to) |
Fonctions protégées
| virtual void | initStyleOption(QStyleOptionTab *option, int tabIndex) const |
| virtual QSize | minimumTabSizeHint(int index) const |
| virtual void | tabInserted(int index) |
| virtual void | tabLayoutChange() |
| virtual void | tabRemoved(int index) |
| virtual QSize | tabSizeHint(int index) const |
Fonctions protégées réimplémentées
| virtual void | changeEvent(QEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual void | hideEvent(QHideEvent *) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *) override |
| virtual void | resizeEvent(QResizeEvent *) override |
| virtual void | showEvent(QShowEvent *) override |
| virtual void | timerEvent(QTimerEvent *event) override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Description détaillée
QTabBar est simple à utiliser ; il dessine les onglets à l'aide d'un des modèles prédéfinis shapes et émet un signal lorsqu'un onglet est sélectionné. Il est possible de créer des sous-classes pour personnaliser son apparence. Qt fournit également un modèle prêt à l'emploi QTabWidget.
Chaque onglet dispose d’une fonction tabText(), d’une fonction optionnelle tabIcon(), d’une fonction optionnelle tabToolTip(), d’une fonction optionnelle tabWhatsThis() et d’une fonction optionnelle tabData(). Les attributs des onglets peuvent être modifiés à l’aide des fonctions setTabText(), setTabIcon(), setTabToolTip(), setTabWhatsThis et setTabData(). Chaque onglet peut être activé ou désactivé individuellement à l’aide de la fonction setTabEnabled().
Chaque onglet peut afficher du texte dans une couleur distincte. La couleur actuelle du texte d’un onglet peut être obtenue à l’aide de la fonction tabTextColor(). Définissez la couleur du texte d’un onglet particulier à l’aide de setTabTextColor().
Les onglets sont ajoutés à l’aide de ` addTab()`, ou insérés à des positions précises à l’aide de ` insertTab()`. Le nombre total d’onglets est fourni par ` count()`. Les onglets peuvent être supprimés de la barre d’onglets à l’aide de ` removeTab()`. En combinant ` removeTab()` et ` insertTab()`, vous pouvez déplacer les onglets vers différentes positions.
La propriété shape définit l’apparence des onglets. Le choix de la forme est une question de goût, bien que les boîtes de dialogue à onglets (pour les préférences et autres) utilisent invariablement RoundedNorth. Les contrôles à onglets dans les fenêtres autres que les boîtes de dialogue utilisent presque toujours soit RoundedSouth soit TriangularSouth. De nombreux tableurs et autres contrôles à onglets dans lesquels toutes les pages sont essentiellement similaires utilisent TriangularSouth, tandis que RoundedSouth est principalement utilisé lorsque les pages sont différentes (par exemple, une palette d’outils à plusieurs pages). La valeur par défaut dans QTabBar est RoundedNorth.
La partie la plus importante de l’API de QTabBar est le signal ` currentChanged()`. Celui-ci est émis chaque fois que l’onglet actif change (même au démarrage, lorsque l’onglet actif passe de « aucun » à un autre). Il existe également un slot, ` setCurrentIndex()`, qui peut être utilisé pour sélectionner un onglet par programmation. La fonction currentIndex() renvoie l’index de l’onglet actif, tandis que count contient le nombre d’onglets.
QTabBar crée automatiquement des touches mnémoniques selon le principe QAbstractButton; par exemple, si le libellé d’un onglet est « &Graphics », Alt+G devient un raccourci clavier permettant de basculer vers cet onglet.
Les fonctions virtuelles suivantes peuvent devoir être réimplémentées afin de personnaliser l’apparence et le comportement ou de stocker des données supplémentaires dans chaque onglet :
- tabSizeHint() calcule la taille d’un onglet.
- tabInserted() signale qu’un nouvel onglet a été ajouté.
- tabRemoved() signale qu’un onglet a été supprimé.
- tabLayoutChange() signale que la disposition des onglets a été modifiée.
- paintEvent() affiche tous les onglets.
Pour les sous-classes, vous pourriez également avoir besoin des fonctions ` tabRect()` qui renvoient la géométrie visuelle d’un onglet individuel.
 | Une barre d’onglets affichée dans le style de widget Fusion. |
 | Une barre d’onglets tronquée affichée dans le style de widget Fusion. |
Voir également QTabWidget.
Documentation sur les types de membres
enum QTabBar::ButtonPosition
Ce type d'énumération indique l'emplacement du widget sur un onglet.
| Constante | Valeur | Description |
|---|---|---|
QTabBar::LeftSide | 0 | Côté gauche de l'onglet. |
QTabBar::RightSide | 1 | Côté droit de l'onglet. |
enum QTabBar::SelectionBehavior
Ce type d'énumération répertorie les comportements de QTabBar lorsqu'un onglet est supprimé et que l'onglet supprimé est également l'onglet actif.
| Constante | Valeur | Description |
|---|---|---|
QTabBar::SelectLeftTab | 0 | Sélectionne l'onglet situé à gauche de celui qui est supprimé. |
QTabBar::SelectRightTab | 1 | Sélectionne l'onglet situé à droite de celui en cours de suppression. |
QTabBar::SelectPreviousTab | 2 | Sélectionnez l'onglet précédemment sélectionné. |
enum QTabBar::Shape
Ce type d'énumération répertorie les formes intégrées prises en charge par QTabBar. Considérez ces informations comme des indications, car certains styles peuvent ne pas afficher certaines de ces formes. Toutefois, leur position devrait être respectée.
| Constante | Valeur | Description |
|---|---|---|
QTabBar::RoundedNorth | 0 | L'aspect arrondi standard au-dessus des pages |
QTabBar::RoundedSouth | 1 | L'aspect arrondi standard en bas des pages |
QTabBar::RoundedWest | 2 | L'aspect arrondi standard sur le côté gauche des pages |
QTabBar::RoundedEast | 3 | L'aspect arrondi standard sur le côté droit des pages |
QTabBar::TriangularNorth | 4 | Des onglets triangulaires au-dessus des pages. |
QTabBar::TriangularSouth | 5 | Des onglets triangulaires similaires à ceux utilisés dans le tableur Excel, par exemple |
QTabBar::TriangularWest | 6 | Onglets triangulaires à gauche des pages. |
QTabBar::TriangularEast | 7 | Onglets triangulaires à droite des pages. |
Documentation sur les propriétés
autoHide : bool
Si cette valeur est définie sur « true », la barre d'onglets est automatiquement masquée lorsqu'elle contient moins de 2 onglets.
Par défaut, cette propriété est définie sur « false ».
Fonctions d'accès :
| bool | autoHide() const |
| void | setAutoHide(bool hide) |
Voir aussi QWidget::visible.
changeCurrentOnDrag : bool
Si cette option est activée, l'onglet actif change automatiquement lorsque l'on fait glisser le curseur sur la barre d'onglets.
Remarque : vous devez également définir la propriété acceptDrops sur true pour que cette fonctionnalité fonctionne.
Par défaut, cette propriété est définie sur « false ».
Fonctions d'accès :
| bool | changeCurrentOnDrag() const |
| void | setChangeCurrentOnDrag(bool change) |
[read-only] count : int
Cette propriété contient le nombre d'onglets de la barre d'onglets
Fonctions d'accès :
| int | count() const |
currentIndex : int
Cette propriété contient l'index de l'onglet visible dans la barre d'onglets
L'index actuel est -1 s'il n'y a pas d'onglet actif.
Fonctions d'accès :
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Signal de notification :
| void | currentChanged(int index) |
documentMode : bool
Cette propriété indique si la barre d'onglets est affichée ou non dans un mode adapté à la fenêtre principale.
Cette propriété sert d'indication aux styles pour afficher les onglets d'une manière différente de celle qu'ils auraient normalement dans un widget d'onglets. Sous macOS, leur apparence sera similaire à celle des onglets dans Safari ou dans l'application Terminal.app de Sierra.
Fonctions d'accès :
| bool | documentMode() const |
| void | setDocumentMode(bool set) |
Voir également QTabWidget::documentMode.
drawBase : bool
Détermine si la barre d'onglets doit afficher ou non sa base.
Si la valeur est « true », alors « QTabBar » dessine une base en fonction du chevauchement des styles. Sinon, seuls les onglets sont dessinés.
Fonctions d'accès :
| bool | drawBase() const |
| void | setDrawBase(bool drawTheBase) |
Voir également QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap et QStyleOptionTabBarBase.
elideMode : Qt::TextElideMode
Comment tronquer le texte dans la barre d'onglets
Cette propriété contrôle la manière dont les éléments sont tronqués lorsqu’il n’y a pas suffisamment d’espace pour les afficher compte tenu de la taille de la barre d’onglets.
Par défaut, la valeur dépend du style.
Fonctions d’accès :
| Qt::TextElideMode | elideMode() const |
| void | setElideMode(Qt::TextElideMode mode) |
Voir également QTabWidget::elideMode, usesScrollButtons et QStyle::SH_TabBar_ElideMode.
expanding : bool
Lorsque l'option « expand » est activée ( QTabBar ), les onglets s'étendent pour occuper l'espace libre.
Par défaut, la valeur est « true ».
Fonctions d'accès :
| bool | expanding() const |
| void | setExpanding(bool enabled) |
Voir également QTabWidget::documentMode.
iconSize : QSize
Cette propriété définit la taille des icônes dans la barre d'onglets
La valeur par défaut dépend du style. « iconSize » correspond à la taille maximale ; les icônes plus petites ne sont pas agrandies.
Fonctions d'accès :
| QSize | iconSize() const |
| void | setIconSize(const QSize &size) |
Voir également QTabWidget::iconSize.
movable : bool
Cette propriété détermine si l'utilisateur peut déplacer les onglets au sein de la zone de la barre d'onglets.
Par défaut, cette propriété est définie sur « false » ;
Fonctions d'accès :
| bool | isMovable() const |
| void | setMovable(bool movable) |
selectionBehaviorOnRemove : SelectionBehavior
Quel onglet doit être défini comme onglet actif lorsque la méthode ` removeTab ` est appelée, si l'onglet supprimé est également l'onglet actif ?
Par défaut, la valeur est SelectRightTab.
Fonctions d'accès :
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
Voir également removeTab().
shape : Shape
Cette propriété définit la forme des onglets dans la barre d'onglets
Les valeurs possibles pour cette propriété sont décrites par l'énumération Shape.
Fonctions d'accès :
| QTabBar::Shape | shape() const |
| void | setShape(QTabBar::Shape shape) |
tabsClosable : bool
Cette propriété détermine si une barre d'onglets doit afficher ou non des boutons de fermeture sur chaque onglet
Lorsque `tabsClosable` est défini sur `true`, un bouton de fermeture apparaît sur l'onglet, à gauche ou à droite selon le style. Lorsque l'on clique directement sur ce bouton, ou qu'un clic avec le bouton central de la souris est détecté n'importe où sur l'onglet, le signal ` tabCloseRequested ` est émis.
Par défaut, la valeur est « false ».
Fonctions d'accès :
| bool | tabsClosable() const |
| void | setTabsClosable(bool closable) |
Voir également ` setTabButton()` et ` tabRemoved()`.
usesScrollButtons : bool
Cette propriété détermine si une barre d'onglets doit ou non utiliser des boutons pour faire défiler les onglets lorsqu'elle en comporte un grand nombre.
Lorsqu'une barre d'onglets contient trop d'onglets par rapport à sa taille, elle peut soit s'agrandir, soit ajouter des boutons permettant de faire défiler les onglets.
Par défaut, la valeur dépend du style.
Fonctions d'accès :
| bool | usesScrollButtons() const |
| void | setUsesScrollButtons(bool useButtons) |
Voir également elideMode, QTabWidget::usesScrollButtons et QStyle::SH_TabBar_PreferNoArrows.
Documentation des fonctions membres
[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)
Crée une nouvelle barre d'onglets avec l'parent on indiquée.
[virtual noexcept] QTabBar::~QTabBar()
Supprime la barre d'onglets.
QString QTabBar::accessibleTabName(int index) const
Renvoie l'« accessibleName » de l'onglet situé à la position index, ou une chaîne vide si index est hors limites.
Voir aussi setAccessibleTabName().
int QTabBar::addTab(const QString &text)
Ajoute un nouvel onglet avec le texte « text ». Renvoie l'index du nouvel onglet.
int QTabBar::addTab(const QIcon &icon, const QString &text)
Ajoute un nouvel onglet avec l'icône icon et le texte text. Renvoie l'index du nouvel onglet.
Il s'agit d'une fonction surchargée.
[override virtual protected] void QTabBar::changeEvent(QEvent *event)
Réimplémente : QWidget::changeEvent(QEvent *event).
[signal] void QTabBar::currentChanged(int index)
Ce signal est émis lorsque l'onglet actif de la barre d'onglets change. Le nouvel onglet actif possède l'index indiquée, ou la valeur -1 s'il n'y en a pas de nouveau (par exemple, s'il n'y a pas d'onglet dans l'QTabBar).
Remarque : signalde notification pour la propriété currentIndex.
[override virtual protected] bool QTabBar::event(QEvent *event)
Réimplémente : QWidget::event(QEvent *event).
[override virtual protected] void QTabBar::hideEvent(QHideEvent *)
Réimplémente : QWidget::hideEvent(QHideEvent *event).
[virtual protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const
Initialisez ` option ` avec les valeurs figurant dans l'onglet disponible à l'adresse tabIndex. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionTab`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.
Voir également QStyleOption::initFrom() et QTabWidget::initStyleOption().
int QTabBar::insertTab(int index, const QString &text)
Insère un nouvel onglet contenant le texte « text » à la position « index ». Si « index » est hors limites, le nouvel onglet est ajouté à la fin. Renvoie l'index du nouvel onglet.
int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)
Insère un nouvel onglet avec l'icône icon et le texte text à la position index. Si index est hors limites, le nouvel onglet est ajouté à la fin. Renvoie l'index du nouvel onglet.
Si QTabBar était vide avant l’appel de cette fonction, l’onglet inséré devient l’onglet actif.
L'insertion d'un nouvel onglet à un index inférieur ou égal à l'index actuel incrémentera l'index actuel, mais conservera l'onglet actuel.
Il s’agit d’une fonction surchargée.
bool QTabBar::isTabEnabled(int index) const
Renvoie « true » si l'onglet situé à l'adresse index est activé ; sinon, renvoie « false ».
bool QTabBar::isTabVisible(int index) const
Renvoie « true » si l'onglet situé à la position index est visible ; sinon, renvoie « false ».
[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)
Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).
[override virtual] QSize QTabBar::minimumSizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.
[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const
Renvoie la valeur minimale suggérée pour la taille de l'onglet situé à la position index.
[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseDoubleClickEvent(QMouseEvent *event).
[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)
Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).
void QTabBar::moveTab(int from, int to)
Déplace l'élément situé à l'index from vers l'index to.
Voir également tabMoved() et tabLayoutChange().
[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)
Réimplémente : QWidget::paintEvent(QPaintEvent *event).
void QTabBar::removeTab(int index)
Supprime l'onglet situé à l'adresse index.
Voir également SelectionBehavior.
[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)
Réimplémente : QWidget::resizeEvent(QResizeEvent *event).
void QTabBar::setAccessibleTabName(int index, const QString &name)
Définit la propriété « accessibleName » de l'onglet situé à l'adresse index sur name.
Voir également accessibleTabName().
void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)
Définit la valeur « widget » dans l’onglet « index ». Le widget est placé à gauche ou à droite en fonction de la valeur de « position ».
Tout widget précédemment défini dans « position » est masqué. Définir « widget » sur « nullptr » masquera le widget actuel situé à l’adresse « position ».
La barre d’onglets prendra possession du widget ; ainsi, tous les widgets définis ici seront supprimés par la barre d’onglets lors de sa destruction, à moins que vous ne réattribuiez séparément le widget à un autre parent après avoir défini un autre widget (ou nullptr).
Voir également tabButton() et tabsClosable().
void QTabBar::setTabData(int index, const QVariant &data)
Définit les données de l'onglet situé à l'adresse index sur data.
Voir aussi tabData().
void QTabBar::setTabEnabled(int index, bool enabled)
Si enabled est vrai, l'onglet situé à l'adresse index est activé ; sinon, l'élément situé à l'adresse index est désactivé.
Voir également isTabEnabled().
void QTabBar::setTabIcon(int index, const QIcon &icon)
Définit l'icône de l'onglet situé à l'adresse index sur icon.
Voir également tabIcon().
void QTabBar::setTabText(int index, const QString &text)
Remplace le texte de l'onglet situé à la position index par text.
Voir également tabText().
void QTabBar::setTabTextColor(int index, const QColor &color)
Définit la couleur du texte de l'onglet dont l'index est indiquée sur la valeur spécifiée color.
Si une couleur non valide est spécifiée, l'onglet utilisera à la place la couleur de premier plan de l'QTabBar.
Voir également tabTextColor().
void QTabBar::setTabToolTip(int index, const QString &tip)
Définit l'info-bulle de l'onglet situé à la position index sur tip.
Voir aussi tabToolTip().
void QTabBar::setTabVisible(int index, bool visible)
Si visible est vrai, afficher l'onglet situé à la position index; sinon, le masquer.
Voir également isTabVisible().
void QTabBar::setTabWhatsThis(int index, const QString &text)
Définit le texte d'aide « Qu'est-ce que c'est ? » de l'onglet situé à l'adresse index sur text.
Voir également tabWhatsThis().
[override virtual protected] void QTabBar::showEvent(QShowEvent *)
Réimplémente : QWidget::showEvent(QShowEvent *event).
[override virtual] QSize QTabBar::sizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.
int QTabBar::tabAt(const QPoint &position) const
Renvoie l'index de l'onglet qui recouvre position ou -1 si aucun onglet ne recouvre position;
[signal] void QTabBar::tabBarClicked(int index)
Ce signal est émis lorsque l'utilisateur clique sur un onglet d'un index.
index Il s'agit de l'index de l'onglet sur lequel l'utilisateur a cliqué, ou -1 si aucun onglet ne se trouve sous le curseur.
[signal] void QTabBar::tabBarDoubleClicked(int index)
Ce signal est émis lorsque l'utilisateur double-clique sur un onglet de la page index.
index Il s'agit de l'onglet sur lequel l'utilisateur a cliqué, ou -1 si aucun onglet ne se trouve sous le curseur.
QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const
Renvoie l'onglet défini pour le widget index et position ou nullptr si aucun n'est défini.
Voir également setTabButton().
[signal] void QTabBar::tabCloseRequested(int index)
Ce signal est émis lorsque l'utilisateur clique sur le bouton « Fermer » d'un onglet. L'index correspond à l'index de l'onglet à supprimer.
Voir également setTabsClosable().
QVariant QTabBar::tabData(int index) const
Renvoie les données de l'onglet situé à la position index, ou une variante nulle si index est hors limites.
Voir également setTabData().
QIcon QTabBar::tabIcon(int index) const
Renvoie l'icône de l'onglet situé à la position index, ou une icône nulle si index est hors de la plage autorisée.
Voir également setTabIcon().
[virtual protected] void QTabBar::tabInserted(int index)
Ce gestionnaire virtuel est appelé lorsqu'un nouvel onglet a été ajouté ou inséré à la position index.
Voir également tabRemoved().
[virtual protected] void QTabBar::tabLayoutChange()
Ce gestionnaire virtuel est appelé chaque fois que la disposition des onglets change.
Voir également tabRect().
[signal] void QTabBar::tabMoved(int from, int to)
Ce signal est émis lorsque l'onglet a déplacé l'onglet situé à l'index from vers l'index to.
Remarque : QTabWidget fait automatiquement défiler la page lorsque ce signal est émis depuis sa barre d’onglets.
Voir aussi moveTab().
QRect QTabBar::tabRect(int index) const
Renvoie le rectangle visuel de l'onglet situé à la position index, ou un rectangle nul si index est masqué ou hors limites.
[virtual protected] void QTabBar::tabRemoved(int index)
Ce gestionnaire virtuel est appelé lorsqu'une tabulation a été supprimée de la position index.
Voir également tabInserted().
[virtual protected] QSize QTabBar::tabSizeHint(int index) const
Renvoie l'indication de taille de l'onglet situé à la position index.
QString QTabBar::tabText(int index) const
Renvoie le texte de l'onglet situé à la position index, ou une chaîne vide si index est hors limites.
Voir aussi setTabText().
QColor QTabBar::tabTextColor(int index) const
Renvoie la couleur du texte de l'onglet correspondant à l'index donnée, ou une couleur non valide si l'index est hors de la plage autorisée.
Voir aussi setTabTextColor().
QString QTabBar::tabToolTip(int index) const
Renvoie l'info-bulle de l'onglet situé à la position index, ou une chaîne vide si index est hors de la plage autorisée.
Voir également setTabToolTip().
QString QTabBar::tabWhatsThis(int index) const
Renvoie le texte d'aide « Qu'est-ce que c'est ? » de l'onglet situé à la position index, ou une chaîne vide si index est hors de la plage autorisée.
Voir également setTabWhatsThis().
[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)
Réimplémente : QObject::timerEvent(QTimerEvent *event).
[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)
Réimplémente : QWidget::wheelEvent(QWheelEvent *event).
© 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.
