QStatusBar

La classe QStatusBar fournit une barre horizontale adapt�e � la pr�sentation d?informations d?�tat. Plus d'informations...

 #include <QStatusBar>

H�ritage

H�rite de QWidget.

Description d�taill�e

La classe QStatusBar fournit une barre horizontale adapt�e � la pr�sentation d?informations d?�tat.

Chaque indicateur d?�tat rentre dans une de ces trois cat�gories :

• temporaire - occupe bri�vement la plus grande partie de la barre d?�tat. Utilis� par exemple pour expliquer les textes des infobulles ou les entr�es de menu ;
• normal - occupe une petite partie de la barre d?�tat et peut �tre cach� par les messages temporaires. Utilis� par exemple pour afficher la page et le num�ro de ligne dans un traitement de texte ;
• permanent - n?est jamais cach�. Utilis� pour les indications importantes sur le mode de fonctionnement, certaines applications pr�sentent par exemple un indicateur Caps Lock (verrou majuscules) dans la barre d?�tat.

QStatusBar permet l?affichage de ces trois types d?indicateur.

Typiquement, les fonctionnalit�s de la barre d?�tat sont utilis�es en relation avec un objet QMainWindow. La classe QMainWindow fournit une fen�tre principale, avec une barre de menus, des barres d?outils, des widgets dock et une barre d?�tat autour d?un widget central. On peut acc�der � la barre d?�tat en utilisant la fonction QMainWindow::statusBar(), et on peut la remplacer avec QMainWindow::setStatusBar().

Voici comment utiliser le slot showMessage() pour afficher un message temporaire :

 void MainWindow::createStatusBar()
 {
     statusBar()->showMessage(tr("Ready"));
 }

Pour enlever un message temporaire, on utilise le slot clearMessage(), ou alors on d�finit une limite de temps lors de l?appel � showMessage(). Par exemple :

 void MainWindow::print()
 {
 #ifndef QT_NO_PRINTDIALOG
     QTextDocument *document = textEdit->document();
     QPrinter printer;
 
     QPrintDialog *dlg = new QPrintDialog(&printer, this);
     if (dlg->exec() != QDialog::Accepted)
         return;
 
     document->print(&printer);
 
     statusBar()->showMessage(tr("Ready"), 2000);
 #endif
 }

On utilise la fonction currentMessage() pour r�cup�rer le message temporaire actuellement affich�. La classe QStatusBar fournit �galement le signal messageChanged(), �mis chaque fois que le message temporaire change.

Les messages normaux et permanents sont affich�s en cr�ant un petit widget (QLabel, QProgressBar ou encore QToolButton) et en l?ajoutant � la barre d?�tat en utilisant les fonctions addWidget() ou addPermanentWidget(). On utilise la fonction removeWidget() pour effacer ces messages de la barre d?�tat.

 statusBar()->addWidget(new MyReadWriteIndication);

Par d�faut, QStatusBar fournit une poign�e de dimensionnement QSizeGrip dans le coin en bas � droite. On peut la d�sactiver en utilisant la fonction setSizeGripEnabled(). Pour conna�tre l'�tat courant de la poign�e de dimensionnement, on utilise la fonction isSizeGripEnabled().

Voir aussi QMainWindow, QStatusTipEvent, Manuel de conception d?IHM : la barre d?�tat et Exemple d?application.

Propri�t�s

sizeGripEnabled : bool

Cette propri�t� indique si la poign�e de dimensionnement QSizeGrip en bas � droite de la barre d'�tat est activ�e.

La poign�e de dimensionnement est activ�e par d�faut.

Fonction d'acc�s

bool isSizeGripEnabled () const

void setSizeGripEnabled ( bool )

Fonctions membres

QStatusBar::QStatusBar ( QWidget * parent = 0 )

Construit une barre d'�tat avec une poign�e de dimensionnement et le parent donn�.

Voir aussi setSizeGripEnabled().

QStatusBar::~QStatusBar () [virtual]

D�truit la barre d'�tat et lib�re les ressources allou�es et les widgets enfants.

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

Ajoute le widget donn� � la barre d'�tat, de fa�on permanente. Si ce n'est pas d�j� le cas, l'objet QStatusBar devient le parent du widget. Le param�tre d'�tirement stretch est utilis� pour adapter la taille du widget donn� lorsque la barre d'�tat grandit ou r�tr�cit. Le facteur d'�tirement par d�faut est 0, c'est-�-dire que le widget occupe le minimum de place.

��De fa�on permanente�� signifie que le widget ne peut pas �tre cach� par des messages temporaires. Il est positionn� � l'extr�mit� droite de la barre d'�tat.

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

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

Ajoute le widget donn� � la barre d'�tat. Si ce n'est pas d�j� le cas, l'objet QStatusBar devient le parent du widget. Le param�tre d'�tirement stretch est utilis� pour adapter la taille du widget donn� lorsque la barre d'�tat grandit ou r�tr�cit. Le facteur d'�tirement par d�faut est 0, c'est-�-dire que le widget occupe le minimum de place.

Le widget est positionn� � l'extr�mit� gauche du premier widget permanent (voir addPermanentWidget()) et peut �tre cach� par des messages temporaires.

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

void QStatusBar::clearMessage () [slot]

Efface tous les messages temporaires actuellement affich�s.

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

QString QStatusBar::currentMessage () const

Retourne le message temporaire actuellement affich� ou une cha�ne de caract�res vide s'il n'y a pas de message.

Voir aussi showMessage().

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

R�impl�mentation de QObject::event().

void QStatusBar::hideOrShow () [protected]

Assure la visibilit� correcte des widgets.

Utilis� par les fonctions showMessage() etclearMessage().

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

Ins�re le widget donn� � l?index donn� de cette barre d?�tat, de fa�on permanente. Si ce n?est pas d�j� le cas, l?objet QStatusBar devient le parent du widget. Si l?index est en dehors de l?intervalle, le widget est ajout� � la fin (dans ce cas l?index r�el du widget est retourn�).

Le param�tre d?�tirement stretch est utilis� pour adapter la taille du widget donn� lorsque la barre d?�tat grandit ou r�tr�cit. Le facteur d?�tirement par d�faut est 0, c?est-�-dire que le widget occupe le minimum de place.

De fa�on permanente signifie que le widget ne peut pas �tre cach� par des messages temporaires. Il est positionn� � l'extr�mit� droite de la barre d?�tat.

Cette fonction a �t� introduite dans Qt 4.2.

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

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

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

Ins�re le widget donn� � l?index donn� de cette barre d?�tat. Si ce n?est pas d�j� le cas, l?objet QStatusBar devient le parent du widget. Si l?index est en dehors de l?intervalle, le widget est ajout� � la fin (dans ce cas l?index r�el du widget est retourn�).

Le param�tre d?�tirement stretch est utilis� pour adapter la taille du widget donn� lorsque la barre d?�tat grandit ou r�tr�cit. Le facteur d?�tirement par d�faut est 0, c?est-�-dire que le widget occupe le minimum de place.

Le widget est positionn� � l'extr�mit� gauche du premier widget permanent (voir addPermanentWidget()), et peut �tre cach� par des messages temporaires.

Cette fonction a �t� introduite dans Qt 4.2.

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

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

Ce signal est �mis � chaque fois que le message temporaire change. Le nouveau message temporaire est contenu dans le param�tre message qui est une cha�ne nulle lorsque le message a �t� effac�.

Voir aussi showMessage() and clearMessage().

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

R�impl�mentation de QWidget::paintEvent().

Affiche le message temporaire, le cas �ch�ant, en r�ponse � l'�v�nement de peinture event.

void QStatusBar::reformat () [protected]

Change l'apparence de la barre d'�tat pour prendre en compte les changements de ses �l�ments.

Certaines sous-classes sp�cifiques peuvent avoir besoin de cette fonction, mais de mani�re g�n�rale le gestionnaire de g�om�trie prend en charge tous les remaniements n�cessaires.

void QStatusBar::removeWidget ( QWidget * widget )

Enl�ve le widget sp�cifi� de la barre d'�tat.

� noter : cette fonction ne supprime pas le widget mais le cache. Pour ajouter de nouveau le widget, il faut appeler les deux fonctions addWidget() et show().

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

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

R�impl�mentation de QWidget::resizeEvent().

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

R�impl�mentation de QWidget::showEvent().

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

Cache les indicateurs d'�tat normaux et affiche le message donn�, pendant la dur�e sp�cifi�e en millisecondes (timeout). Si timeout est � 0 (valeur par d�faut), le 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.

� noter que showMessage() est appel� pour afficher des explications temporaires sur les textes des infobulles, et que par cons�quent passer un timeout � 0 n?est pas suffisant pour afficher un message permanent.

Voir aussi messageChanged(), currentMessage() et clearMessage().

Remerciements

Merci � Lo?c Leguay pour la traduction, ainsi qu'� Ilya Diallo et Claude Leloup pour la relecture !