QTabWidget Class

Documentation sur les fonctions membres

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

Construit un widget à onglets avec le parent parent.

[virtual noexcept] QTabWidget::~QTabWidget()

Détruit le widget à onglets.

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

Ajoute un onglet avec les valeurs page et label au widget tab, et renvoie l'index de l'onglet dans la barre d'onglets. La propriété de page est transmise à QTabWidget.

Si l'adresse label de l'onglet contient une esperluette, la lettre qui suit l'esperluette est utilisée comme raccourci pour l'onglet. Par exemple, si l'étiquette est "Bro&wse", Alt+W devient un raccourci qui déplacera le focus sur cet onglet.

Voir également insertTab().

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

Ajoute un onglet avec les valeurs page, icon, et label au widget tab, et renvoie l'index de l'onglet dans la barre d'onglets. La propriété de page est transmise à QTabWidget.

Cette fonction est la même que addTab(), mais avec un 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. Appeler cette fonction équivaut à appeler removeTab() jusqu'à ce que le widget d'onglets soit vide.

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

Renvoie le widget affiché dans le corner du widget d'onglet ou nullptr.

Voir aussi setCornerWidget().

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

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

Voir également currentWidget() et currentIndex.

QWidget *QTabWidget::currentWidget() const

Renvoie un pointeur sur la page actuellement affichée par la boîte de dialogue des onglets. La boîte de dialogue des onglets fait de son mieux pour s'assurer que cette valeur n'est jamais 0 (mais si vous essayez assez fort, elle peut l'être).

Voir aussi 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 la position de 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

Initialiser option avec les valeurs de QTabWidget. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionTabWidgetFrame, mais qui ne veulent pas remplir toutes les informations elles-mêmes.

Voir aussi QStyleOption::initFrom() et QTabBar::initStyleOption().

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

Insère un onglet avec les adresses label et page dans le widget d'onglets à l'adresse index, et renvoie l'index de l'onglet inséré dans la barre d'onglets. La propriété de page est transmise à QTabWidget.

L'étiquette est affichée dans l'onglet et son apparence peut varier en fonction de la configuration du widget d'onglet.

Si l'adresse label de l'onglet contient une esperluette, la lettre qui suit l'esperluette est utilisée comme raccourci pour l'onglet, par exemple si l'étiquette est "Bro&wse", Alt+W devient un raccourci qui déplacera le focus sur cet onglet.

Si index est hors de portée, l'onglet est simplement ajouté. Sinon, il est inséré à la position spécifiée.

Si le site QTabWidget était vide avant l'appel de cette fonction, la nouvelle page devient la page en cours. L'insertion d'une nouvelle tabulation à 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 données label, page, et icon dans le widget d'onglet à l'endroit spécifié index, et renvoie l'index de l'onglet inséré dans la barre d'onglets. La propriété de page est transmise à QTabWidget.

Cette fonction est identique à insertTab(), mais elle comporte un élément supplémentaire : icon.

bool QTabWidget::isTabEnabled(int index) const

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

Voir aussi setTabEnabled() et QWidget::isEnabled().

bool QTabWidget::isTabVisible(int index) const

Retourne vrai si la page à la position index est visible, sinon retourne faux.

Voir également 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 à la propriété : QWidget::minimumSizeHint.

Renvoie une taille minimale appropriée pour l'onglet.

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

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

Peint la barre d'onglets du widget tab en réponse à l'événement paint event.

void QTabWidget::removeTab(int index)

Supprime l'onglet situé à la position index de cette pile de widgets. Le widget de 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'adresse widget donnée comme étant affichée dans l'adresse corner spécifiée du widget de l'onglet. La géométrie du widget est déterminée en fonction de sizeHint() et de style().

Seul l'élément horizontal de corner sera utilisé.

Si vous passez nullptr, aucun widget n'apparaît dans le coin.

Tout widget d'angle précédemment défini est caché.

Tous les widgets définis ici seront supprimés par le widget de l'onglet lorsqu'il sera détruit, à moins que vous ne répartissiez séparément le widget après avoir défini un autre widget de coin (ou nullptr).

Remarque : les widgets d'angle sont conçus pour les onglets North et South; les autres orientations sont connues pour ne pas fonctionner correctement.

Voir également cornerWidget() et setTabPosition().

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

Fait de widget le widget actuel. L'adresse widget utilisée doit être une page de cet onglet.

Voir aussi addTab(), setCurrentIndex() et currentWidget().

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

Remplace l'en-tête de la boîte de dialogue QTabBar par la barre d'onglets tb. Notez que cette commande doit être appelée avant que des onglets n'aient été ajoutés, sinon le comportement n'est pas défini.

Voir aussi tabBar().

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

Si enable est vrai, la page à la position index est activée ; sinon, la page à la position index est désactivée. L'onglet de la page est redessiné en conséquence.

QTabWidget utilise QWidget::setEnabled() en interne, plutôt que de conserver un indicateur séparé.

Notez que même un onglet/une page désactivé(e) peut être visible. Si la page est déjà visible, QTabWidget ne la cachera pas ; si toutes les pages sont désactivées, QTabWidget en affichera une.

Voir aussi isTabEnabled() et QWidget::setEnabled().

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

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

Voir aussi tabIcon().

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

Définit un nouveau label pour la page à la position index's tab.

Si le texte fourni contient une esperluette ('&'), un raccourci est automatiquement créé. Le caractère qui suit le "&" sera utilisé comme touche de raccourci. Tout raccourci précédent sera écrasé, ou effacé si aucun raccourci n'est défini pour le texte. Voir la documentation de QShortcut pour plus de détails (pour afficher une esperluette, utiliser '&&').

Voir également tabText().

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

Définit l'info-bulle de l'onglet pour la page à la position index à tip.

Voir aussi tabToolTip().

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

Si visible est vrai, la page à la position index est visible ; sinon, la page à la position index est cachée. L'onglet de la page est redessiné en conséquence.

Voir également isTabVisible().

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

Définit le texte d'aide "What's This" pour la page à la position index à text.

Voir aussi 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 à la propriété : QWidget::sizeHint.

QTabBar *QTabWidget::tabBar() const

Renvoie l'adresse actuelle QTabBar.

Voir aussi setTabBar().

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

Ce signal est émis lorsque l'utilisateur clique sur un onglet à l'adresse index.

index se réfère à l'onglet 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 est l'index de l'onglet cliqué, ou -1 si aucun onglet ne se trouve sous le curseur.

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

Ce signal est émis lorsque le bouton de fermeture d'un onglet est cliqué. L'adresse index est l'index qui doit être supprimé.

Voir aussi setTabsClosable().

QIcon QTabWidget::tabIcon(int index) const

Renvoie l'icône de l'onglet sur la page à la position index.

Voir aussi setTabIcon().

[virtual protected] void QTabWidget::tabInserted(int index)

Ce gestionnaire virtuel est appelé après l'ajout ou l'insertion d'un nouvel onglet à la position index.

Voir aussi tabRemoved().

[virtual protected] void QTabWidget::tabRemoved(int index)

Ce gestionnaire virtuel est appelé après qu'un onglet a été retiré de la position index.

Voir aussi tabInserted().

QString QTabWidget::tabText(int index) const

Renvoie le texte de l'étiquette de l'onglet de la page à la position index.

Voir également setTabText().

QString QTabWidget::tabToolTip(int index) const

Renvoie l'info-bulle de la page à la position 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 What's This pour la page à la position 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 la page à onglet à la position d'index index ou nullptr si index est hors de portée.