# Programmation GTK2 en Pascal/GtkStatusBar

* Programmation GTK2 en Pascal
* Introduction
* Pré-requis
* Logiciels nécessaires
* Installation sous Linux
* Installation sous Windows
* Installation sous Mac/OS
* Une application minimale
* Les bases
* La notion d'objet
* La gestion des évènements
* Le placement des contrôles
* Les contrôles (widgets) Gtk
* Les fenêtres
* Les conteneurs
* Les visuels
* Les boutons
* La saisie de données
* Les listes déroulantes
* Les menus
* Les décorations
* La barre d'outils
* Les sélections
* Les zones de texte
* Les listes et arbres
* La Glib : objets et fonctions
* Dessiner avec le Gdk
* Conclusion
* Bibliographie

## Présentation

Le contrôle GtkStatusBar est une barre d'état qui peut avoir plusieurs utilités. Tout d'abord lorsqu'un programme est en train d'effectuer une action, elle peut servir à signaler à l'utilisateur ce que le programme fait. Elle peut aussi servir à expliquer l'utilité d'un bouton (ou d'un élément du menu).

### Hiérarchie

* Hiérarchie
* GObject
* └─GtkObject
* └─GtkWidget
* └─GtkContainer
* └─GtkBox
* └─GtkHBox
* └─GtkStatusBar

## Utilisation de base
### Création

La création de ce contrôle est aussi simple que pour tous les autres contrôles. Il suffit d'utiliser cette fonction :

### Identification

Regardons tout d'abord comment fonctionne une GtkStatusBar. Les messages sont mis dans une pile, l'élément le plus haut de la pile étant affiché. Mais avant de pouvoir ajouter un message dans la pile, il faut que Gtk+ sache qui a envoyé le message. En effet pour la barre d'état, nous avons la possibilité de définir quelle partie (ou quel module) du programme a envoyé un message.
Donc avant de pouvoir insérer des messages, il faut créer un ou plusieurs identifiant suivant le cas avec cette fonction :
Cette fonction va automatiquement ajouter un contexte, et renvoyer la valeur correspondante. Par la suite cet identifiant est à utiliser pour ajouter ou enlever des éléments à la pile.

### Ajout de message

Pour ajouter un élément, il n'y a qu'une seule fonction :
Le paramètre statusbar est bien sûr la barre d'état dans laquelle nous voulons ajouter un message, le paramètre context_id la valeur correspondante au contexte qui a été créé et text le texte qu'il faut afficher dans la barre d'état.
Après l'appel de cette fonction, le message est automatiquement ajouté en haut de la pile et est affiché dans la barre d'état. La valeur de retour correspond à l'identifiant du message dans la pile qui peut être utile pour sa suppression.

### Suppression d'un message

Pour supprimer un message de la pile, nous avons cette fois deux fonctions différentes :
La première fonction enlève l'élément le plus haut placé dans la pile provenant de la partie du programme ayant l'identifiant context_id. Alors que la deuxième fonction enlève l'élément en fonction de son identifiant et celui de son contexte.

## Programme exemple

Nous allons construire une application comportant deux boutons et barre d'état. Le but de cette application et d'afficher un message dans la barre d'état lorsque la souris survole un des boutons.
Voilà le fichier gtk016.pas :
Voilà ce que donne l'exécution du programme gtk016 :
Avec la souris au dessus du premier bouton (on peut noter le changement de couleur du bouton) :
Puis du deuxième bouton :
* Visuels :
* GtkLabel ~
* GtkImage ~
* GtkStatusBar ~
* GtkProgressBar ~
* GtkDrawingArea