# Programmation GTK2 en Pascal/GtkDialog

* 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 GtkDialog permet de gérer un style de fenêtre particulier : les boîtes de dialogue. Elles permettent de demander à l'utilisateur des informations ou de poser des questions.

### Hiérarchie

* Hiérarchie
* GObject
* └─GtkObject
* └─GtkWidget
* └─GtkContainer
* └─GtkBin
* └─GtkWindow
* └─GtkDialog

## Utilisation de base
### Composition de la boîte de dialogue

Une boîte de dialogue de type GtkDialog est constituée de trois éléments :
* un conteneur GtkVBox global qui contiendra tous les contrôles affichés ;
* un contrôle GtkHSeparator qui sert de séparation entre la zone de saisie et la zone des boutons ;
* un conteneur GtkHBox qui contiendra les boutons de réponse.
On peut donc ainsi distinguer deux zones différentes :
* la zone de travail au-dessus de la GtkHSeparator ;
* la zone de réponse au-dessous de la GtkHSeparator

### Création de la fenêtre

La fonction de création est un peu plus complexe que d'habitude :
Le premier paramètre title n'est autre que le titre de la boîte de dialogue.
Le deuxième paramètre parent sert à désigner la fenêtre parente. Cette valeur peut être égale à NULL.
Le troisième paramètre flags permet de définir certains paramètres de la boîte de dialogue. Ce paramètre peut prendre trois valeurs différentes :
* GTK_DIALOG_MODAL : créer une boîte de dialogue modale, c'est à dire que tant que l'utilisateur n'a pas cliqué sur un des boutons de réponse, les autres fenêtres seront figées ;
* GTK_DIALOG_DESTROY_WITH_PARENT : la boîte de dialogue est détruite si la fenêtre parente est détruite ;
* GTK_DIALOG_NO_SEPARATOR : la ligne de séparation entre la zone de travail et la zone de réponse n'est pas affichée.
Enfin, le dernier paramètre est plutôt une liste de paramètres permettant de définir les boutons de la boîte de dialogue ainsi que les réponses qui leurs sont associées. Pour chaque bouton que nous voulons ajouter, il faut définir le texte du bouton et le type de réponse qui sera envoyé lorsque nous cliquerons sur le bouton. Le texte du bouton peut, comme pour tous les boutons, être un texte normal, un texte avec raccourci (de la forme "_Quitter") ou même une valeur de type GtkStockItem dont voici une toute partie de la liste :
* GTK_STOCK_OK ;
* GTK_STOCK_CANCEL ;
* GTK_STOCK_YES ;
* GTK_STOCK_NO ;
* GTK_STOCK_SAVE.
La valeur de la réponse, peut être un élément de type GtkResponseType ou bien une valeur entière positive que nous pouvons définir nous-mêmes. Le plus simple étant bien sûr d'utiliser les valeurs classiques définies par le type GtkResponseType dont voici la liste :
* GTK_RESPONSE_NONE ;
* GTK_RESPONSE_REJECT ;
* GTK_RESPONSE_ACCEPT ;
* GTK_RESPONSE_DELETE_EVENT ;
* GTK_RESPONSE_OK ;
* GTK_RESPONSE_CANCEL ;
* GTK_RESPONSE_CLOSE ;
* GTK_RESPONSE_YES ;
* GTK_RESPONSE_NO ;
* GTK_RESPONSE_APPLY ;
* GTK_RESPONSE_HELP.
Une fois que tous les boutons ont été définis, il faut le dire à notre fonction de création. Pour cela, il suffit de terminer la liste des paramètres par NULL.

### Ajout d'éléments dans la zone de travail

La majeure partie des éléments de la boîte de dialogue sont maintenant créés. Il reste cependant à ajouter les éléments de la zone de travail pour que la boîte soit complète. Une fois que ceux-ci sont créés, il suffit de les ajouter dans la boîte de dialogue avec la fonction gtk_box_pack_start.
La question est maintenant de savoir comment passer la GtkVBox en paramètre à la fonction gtk_box_pack_start. Nous allons tout simplement utiliser l'opérateur ^. pour l'élément GtkDialog de cette manière :
La boîte de dialogue est maintenant complète.

### Affichage de la boîte de dialogue

L'affichage de la boîte de dialogue comporte deux étapes. Tout d'abord, il faut demander d'afficher tout le contenu de la GtkVBox qui est inclus dans la boîte de dialogue avec la fonction gtk_widget_show_all.
Ensuite il faut afficher la boîte de dialogue elle-même et attendre la réponse de l'utilisateur avec cette fonction :
Le paramètre de cette fonction étant de type PGtkDialog il faut utiliser la fonction de conversion GTK_DIALOG.
Cette fonction affiche l'intégralité de la boîte de dialogue, mais rentre aussi dans une boucle récursive qui ne s'arrêtera que lorsque l'utilisateur cliquera sur un des boutons de retour. La valeur de retour correspond à la valeur associée au bouton cliqué. Si, par hasard, l'utilisateur quitte la boîte de dialogue en cliquant sur la croix de celle-ci, gtk_dialog_run renvoie GTK_DELETE_EVENT.
Une fois la valeur de retour connue, il ne reste plus qu'à agir en conséquence.

## Programme exemple

L'exemple de ce chapitre est constitué d'une fenêtre principale dans laquelle nous allons ajouter un GtkButton et un GtkLabel. Lorsque l'utilisateur clique sur le GtkButton, une boîte de dialogue apparaîtra et demandera à l'utilisateur de saisir son nom. Cette boîte de dialogue sera constituée d'une GtkEntry, d'un GtkButton « OK » et d'un GtkButton « Annuler ». Si l'utilisateur clique sur « OK » le contenu de la GtkEntry sera copié dans le GtkLabel de la fenêtre principale tandis que s'il clique sur « Annuler » on affichera « Vous n'avez rien saisi. » dans le GtkLabel.
Voici le fichier gtk003.pas, pour faire simple il a été utilisé des variables globales ce qui n'est pas forcément à conseiller :
Voila ce que donne l'exécution du programme gtk003 :
La fenêtre principale s'affiche et on clique sur le bouton « Cliquez ici pour saisir votre nom »
Dans la fenêtre de dialogue, on a saisi « Didier » puis cliqué sur « Valider »
Modèle:Programmation GTK2 en Pascal/Fenêtres