QStatusBar Class

statusBar()->showMessage(tr("Ready"));

statusBar()->showMessage(tr("Ready"), 2000);

statusBar()->addWidget(new MyReadWriteIndication);

Documentation des fonctions membres

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

Construit une barre d'état avec une poignée de taille et l'adresse parent.

Voir aussi setSizeGripEnabled().

[virtual noexcept] QStatusBar::~QStatusBar()

Détruit cette barre d'état et libère les ressources allouées et les widgets enfants.

void QStatusBar::addPermanentWidget(QWidget *widget, int stretch = 0)

Ajoute l'objet widget donné de façon permanente à cette barre d'état, en répartissant le widget s'il n'est pas déjà un enfant de cet objet QStatusBar. Le paramètre stretch est utilisé pour calculer une taille appropriée pour l'objet widget au fur et à mesure que la barre d'état grandit et rétrécit. Le facteur d'étirement par défaut est 0, c'est-à-dire qu'il donne au widget un minimum d'espace.

Permanente signifie que le widget ne peut pas être masqué par des messages temporaires. Il est situé à l'extrême droite de la barre d'état.

Voir également insertPermanentWidget(), removeWidget() et addWidget().

void QStatusBar::addWidget(QWidget *widget, int stretch = 0)

Ajoute l'objet widget à cette barre d'état, en répartissant le widget s'il n'est pas déjà un enfant de cet objet QStatusBar. Le paramètre stretch est utilisé pour calculer une taille appropriée pour l'objet widget au fur et à mesure que la barre d'état grandit et rétrécit. Le facteur d'étirement par défaut est 0, c'est-à-dire qu'il donne au widget un minimum d'espace.

Le widget est situé à l'extrême gauche du premier widget permanent (voir addPermanentWidget()) et peut être masqué par des messages temporaires.

Voir également insertWidget(), removeWidget() et addPermanentWidget().

[slot] void QStatusBar::clearMessage()

Supprime tout message temporaire affiché.

Voir aussi currentMessage(), showMessage() et removeWidget().

QString QStatusBar::currentMessage() const

Renvoie le message temporaire actuellement affiché, ou une chaîne vide si ce message n'existe pas.

Voir aussi showMessage().

[override virtual protected] bool QStatusBar::event(QEvent *e)

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

[protected] void QStatusBar::hideOrShow()

Assure que les bons widgets sont visibles.

Utilisé par les fonctions showMessage() et clearMessage().

int QStatusBar::insertPermanentWidget(int index, QWidget *widget, int stretch = 0)

Insère l'objet widget à l'endroit index de façon permanente dans cette barre d'état, en répartissant le widget s'il n'est pas déjà un enfant de cet objet QStatusBar. Si index est hors de portée, le widget est ajouté (dans ce cas, c'est l'index actuel du widget qui est renvoyé).

Le paramètre stretch est utilisé pour calculer une taille appropriée pour l'objet widget au fur et à mesure que la barre d'état grandit et rétrécit. Le facteur d'étirement par défaut est 0, c'est-à-dire qu'il donne au widget un minimum d'espace.

Permanente signifie que le widget ne peut pas être masqué par des messages temporaires. Il est situé à l'extrême droite de la barre d'état.

Voir aussi addPermanentWidget(), removeWidget() et addWidget().

int QStatusBar::insertWidget(int index, QWidget *widget, int stretch = 0)

Insère l'objet widget à l'endroit index dans cette barre d'état, en répartissant le widget s'il n'est pas déjà un enfant de cet objet QStatusBar. Si index est hors de portée, le widget est ajouté (dans ce cas, c'est l'index actuel du widget qui est renvoyé).

Le paramètre stretch est utilisé pour calculer une taille appropriée pour l'objet widget au fur et à mesure que la barre d'état grandit et rétrécit. Le facteur d'étirement par défaut est 0, c'est-à-dire qu'il donne au widget un minimum d'espace.

Le widget est situé à l'extrême gauche du premier widget permanent (voir addPermanentWidget()) et peut être masqué par des messages temporaires.

Voir également addWidget(), removeWidget() et addPermanentWidget().

[signal] void QStatusBar::messageChanged(const QString &message)

Ce signal est émis chaque fois que le message d'état temporaire change. Le nouveau message temporaire est transmis dans le paramètre message qui est une chaîne nulle lorsque le message a été supprimé.

Voir aussi showMessage() et clearMessage().

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

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

Affiche le message temporaire, le cas échéant, en réponse à la peinture event.

[protected] void QStatusBar::reformat()

Modifie l'apparence de la barre d'état pour tenir compte des changements d'éléments.

Des sous-classes spéciales peuvent avoir besoin de cette fonction, mais la gestion de la géométrie se charge généralement des réarrangements nécessaires.

void QStatusBar::removeWidget(QWidget *widget)

Supprime le site widget spécifié de la barre d'état.

Voir également addWidget(), addPermanentWidget() et clearMessage().

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

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

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

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

[slot] void QStatusBar::showMessage(const QString &message, int timeout = 0)

Masque les indications d'état normales et affiche le message message pendant le nombre de milli-secondes spécifié (timeout). Si timeout vaut 0 (valeur par défaut), message reste affiché jusqu'à ce que le slot clearMessage() soit appelé ou jusqu'à ce que le slot showMessage() soit appelé à nouveau pour modifier le message.

Notez que showMessage() est appelé pour afficher des explications temporaires sur les textes des bulles d'aide, donc passer un timeout de 0 n'est pas suffisant pour afficher un permanent message.

Voir également messageChanged(), currentMessage() et clearMessage().