QTabWidget Class

Documentation sur les fonctions membres

[explicit] QTabWidget::QTabWidget(QWidget *parent = nullptr)

Crée un widget à onglets dont le parent est parent.

[virtual noexcept] QTabWidget::~QTabWidget()

Supprime le widget à onglets.

int QTabWidget::addTab(QWidget *page, const QString &label)

Ajoute un onglet avec l’ page et l’ label spécifiés au widget d’onglets, puis renvoie l’index de l’onglet dans la barre d’onglets. La propriété de page est transférée à QTabWidget.

Si l'label de l'onglet contient un « & », la lettre suivant ce symbole est utilisée comme raccourci pour l'onglet ; par exemple, si le libellé est « Bro&wse », la combinaison Alt+W devient un raccourci permettant de déplacer le focus vers cet onglet.

Voir également ` insertTab()`.

int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label)

Ajoute un onglet avec les propriétés ` page`, ` icon` et ` label ` spécifiées au widget d'onglets, puis renvoie l'index de l'onglet dans la barre d'onglets. La propriété de ` page ` est transférée à ` QTabWidget`.

Cette fonction est identique à addTab(), mais avec une icon supplémentaire.

[override virtual protected] void QTabWidget::changeEvent(QEvent *ev)

Réimplémente : QWidget::changeEvent(QEvent *event).

void QTabWidget::clear()

Supprime toutes les pages, mais ne les efface pas. L'appel de cette fonction revient à appeler removeTab() jusqu'à ce que le widget d'onglet soit vide.

QWidget *QTabWidget::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

Renvoie le widget affiché dans la propriété « corner » du widget d'onglet ou dans la propriété « nullptr ».

Voir aussi setCornerWidget().

[signal] void QTabWidget::currentChanged(int index)

Ce signal est émis chaque fois que l'index de la page actuelle change. Le paramètre correspond à la nouvelle position de la page actuelle index, ou à -1 s'il n'y en a pas de nouvelle (par exemple, s'il n'y a pas de widgets dans l'QTabWidget)

Voir également ` currentWidget()` et ` currentIndex`.

QWidget *QTabWidget::currentWidget() const

Renvoie un pointeur vers la page actuellement affichée par la boîte de dialogue des onglets. La boîte de dialogue des onglets fait tout son possible pour s'assurer que cette valeur ne soit jamais égale à 0 (mais si vous vous y efforcez suffisamment, cela peut arriver).

Voir également currentIndex() et setCurrentWidget().

[override virtual protected] bool QTabWidget::event(QEvent *ev)

Réimplémente : QWidget::event(QEvent *event).

[override virtual] bool QTabWidget::hasHeightForWidth() const

Réimplémente : QWidget::hasHeightForWidth() const.

[override virtual] int QTabWidget::heightForWidth(int width) const

Réimplémente : QWidget::heightForWidth(int w) const.

int QTabWidget::indexOf(const QWidget *w) const

Renvoie l'index de la page occupée par le widget w, ou -1 si le widget est introuvable.

[virtual protected] void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const

Initialisez ` option ` avec les valeurs fournies à l'adresse QTabWidget. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionTabWidgetFrame`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.

Voir également QStyleOption::initFrom() et QTabBar::initStyleOption().

int QTabWidget::insertTab(int index, QWidget *page, const QString &label)

Insère un onglet avec les paramètres ` label ` et ` page ` dans le widget d'onglet à l'adresse spécifiée ` index`, et renvoie l'index de l'onglet inséré dans la barre d'onglets. La propriété de ` page ` est transférée à ` QTabWidget`.

Le libellé s’affiche dans l’onglet et son apparence peut varier en fonction de la configuration du widget d’onglet.

Si l'label de l'onglet contient un « & », la lettre suivant ce symbole est utilisée comme raccourci pour l'onglet ; par exemple, si le libellé est « Bro&wse », la combinaison Alt+W devient un raccourci permettant de déplacer le focus vers cet onglet.

Si l’ index est hors de la plage autorisée, l’onglet est simplement ajouté à la fin. Sinon, il est inséré à la position spécifiée.

Si l'QTabWidget était vide avant l'appel de cette fonction, la nouvelle page devient la page actuelle. L'insertion d'un nouvel onglet à un index inférieur ou égal à l'index actuel incrémentera l'index actuel, mais conservera la page actuelle.

Voir également addTab().

int QTabWidget::insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)

Insère un onglet avec les paramètres label, page et icon dans le widget d'onglet à l'adresse spécifiée index, et renvoie l'index de l'onglet inséré dans la barre d'onglets. La propriété de page est transférée à QTabWidget.

Cette fonction est identique à `insertTab()`, mais avec une ` icon` supplémentaire.

bool QTabWidget::isTabEnabled(int index) const

Renvoie true si la page à l'adresse index est activée ; sinon, renvoie false.

Voir également setTabEnabled() et QWidget::isEnabled().

bool QTabWidget::isTabVisible(int index) const

Renvoie « true » si la page à l'adresse index est visible ; sinon, renvoie « false ».

Voir aussi setTabVisible().

[override virtual protected] void QTabWidget::keyPressEvent(QKeyEvent *e)

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

[override virtual] QSize QTabWidget::minimumSizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.

Renvoie une taille minimale appropriée pour le widget d'onglet.

[override virtual protected] void QTabWidget::paintEvent(QPaintEvent *event)

Réimplémente : QWidget::paintEvent(QPaintEvent *event).

Dessine la barre d'onglets du widget d'onglets en réponse à l'event de dessin.

void QTabWidget::removeTab(int index)

Supprime l'onglet situé à la position index de cette pile de widgets. Le widget « page » lui-même n'est pas supprimé.

Voir également addTab() et insertTab().

[override virtual protected] void QTabWidget::resizeEvent(QResizeEvent *e)

Réimplémente : QWidget::resizeEvent(QResizeEvent *event).

void QTabWidget::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

Définit l'widget on indiquée comme devant s'afficher dans l'corner on spécifiée du widget d'onglet. La géométrie du widget est déterminée en fonction des méthodes ` sizeHint()` et ` style()` du widget.

Seule la composante horizontale de l'corner sera utilisée.

Si l’on transmet nullptr, aucun widget n’apparaîtra dans le coin.

Tout widget de coin précédemment défini est masqué.

Tous les widgets définis ici seront supprimés par le widget d’onglet lors de sa destruction, à moins que vous ne redéfinissiez séparément le parent du widget après avoir défini un autre widget de coin (ou nullptr).

Remarque : les widgets d’angle sont conçus pour les positions d’onglet « North » et « South » ; les autres orientations ne fonctionnent pas correctement.

Voir également cornerWidget() et setTabPosition().

[slot] void QTabWidget::setCurrentWidget(QWidget *widget)

Définit widget comme widget actif. L'widget utilisé doit être une page de ce widget d'onglet.

Voir également addTab(), setCurrentIndex() et currentWidget().

[protected] void QTabWidget::setTabBar(QTabBar *tb)

Remplace l'en-tête « QTabBar » de la boîte de dialogue par la barre d'onglets « tb ». Notez que cette fonction doit être appelée avant l'ajout de tout onglet, sous peine d'un comportement indéfini.

Voir également tabBar().

void QTabWidget::setTabEnabled(int index, bool enable)

Si enable est vrai, la page située à l'adresse index est activée ; dans le cas contraire, la page située à l'adresse index est désactivée. L'onglet de la page est mis à jour en conséquence.

QTabWidget utilise en interne la fonction QWidget::setEnabled(), plutôt que de gérer un indicateur distinct.

Notez qu’un onglet ou une page désactivé(e) peut tout de même être visible. Si la page est déjà visible, la fonction QTabWidget ne la masquera pas ; si toutes les pages sont désactivées, la fonction QTabWidget en affichera une.

Voir également isTabEnabled() et QWidget::setEnabled().

void QTabWidget::setTabIcon(int index, const QIcon &icon)

Définit l'icon de l'onglet situé à la position index.

Voir aussi tabIcon().

void QTabWidget::setTabText(int index, const QString &label)

Définit un nouveau raccourci clavier ( label ) pour l'onglet de la page accessible à l'adresse index.

Si le texte fourni contient le caractère « & » (ampérande), un raccourci est automatiquement créé pour celui-ci. Le caractère suivant le « & » sera utilisé comme touche de raccourci. Tout raccourci existant sera écrasé, ou supprimé si aucun raccourci n’est défini par le texte. Consultez la documentation relative à la fonction QShortcut pour plus de détails (pour afficher un « et commercial » réel, utilisez « && »).

Voir également tabText().

void QTabWidget::setTabToolTip(int index, const QString &tip)

Définit l'info-bulle de l'onglet de la page située à l'adresse index sur tip.

Voir également tabToolTip().

void QTabWidget::setTabVisible(int index, bool visible)

Si visible est vrai, la page située à l'adresse index est visible ; dans le cas contraire, la page située à l'adresse index est masquée. L'onglet de la page est mis à jour en conséquence.

Voir également isTabVisible().

void QTabWidget::setTabWhatsThis(int index, const QString &text)

Définit le texte d'aide « Qu'est-ce que c'est ? » de la page à l'adresse index sur text.

Voir également tabWhatsThis().

[override virtual protected] void QTabWidget::showEvent(QShowEvent *)

Réimplémente : ` QWidget::showEvent(QShowEvent *event)`.

[override virtual] QSize QTabWidget::sizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.

QTabBar *QTabWidget::tabBar() const

Renvoie l’ QTabBar e actuelle.

Voir aussi setTabBar().

[signal] void QTabWidget::tabBarClicked(int index)

Ce signal est émis lorsque l'utilisateur clique sur un onglet d'une page index.

index Il indique l'onglet sur lequel l'utilisateur a cliqué, ou -1 si aucun onglet ne se trouve sous le curseur.

[signal] void QTabWidget::tabBarDoubleClicked(int index)

Ce signal est émis lorsque l'utilisateur double-clique sur un onglet à l'adresse 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 QTabWidget::tabCloseRequested(int index)

Ce signal est émis lorsque l'on clique sur le bouton « Fermer » d'un onglet. L'index correspond à l'index de l'onglet à supprimer.

Voir également setTabsClosable().

QIcon QTabWidget::tabIcon(int index) const

Renvoie l'icône de l'onglet de la page situé à l'adresse index.

Voir aussi setTabIcon().

[virtual protected] void QTabWidget::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 QTabWidget::tabRemoved(int index)

Ce gestionnaire virtuel est appelé lorsqu'une tabulation a été supprimée de la position index.

Voir également tabInserted().

QString QTabWidget::tabText(int index) const

Renvoie le texte de l'étiquette correspondant à l'onglet de la page situé à l'adresse index.

Voir aussi setTabText().

QString QTabWidget::tabToolTip(int index) const

Renvoie l'info-bulle de l'onglet correspondant à la page à l'adresse index ou une chaîne vide si aucune info-bulle n'a été définie.

Voir aussi setTabToolTip().

QString QTabWidget::tabWhatsThis(int index) const

Renvoie le texte d'aide « Qu'est-ce que c'est ? » correspondant à la page située à l'adresse index, ou une chaîne vide si aucun texte d'aide n'a été défini.

Voir aussi setTabWhatsThis().

QWidget *QTabWidget::widget(int index) const

Renvoie l'onglet situé à l'index index ou nullptr si l'index e est hors limites.