GtkDialog

typedef struct 
	{
	GtkWidget *vbox;
	GtkWidget *action_area;
	} GtkDialog;

action_area est un GtkHButtonBox placé après le séparateur  GtkHSeparator dans ledialogue. Il est traité exactement pareil que n'importe quel GtkHButtonBox.

enum GtkDialogFlags

typedef enum
{
GTK_DIALOG_MODAL = 1 << 0, /* appelle  gtk_window_set_modal (win, TRUE) */
GTK_DIALOG_DESTROY_WITH_PARENT = 1 << 1, /* appelle gtk_window_set_destroy_with_parent () */
GTK_DIALOG_NO_SEPARATOR = 1 << 2 /* pas de séparateur au dessus des boutons */
} GtkDialogFlags;

enum GtkResponseType

typedef enum
{
/* GTK retourne ceci si GTK renvoie ceci si un widget de réponse n'a aucun identifiant de response, 
   * ou si le dialogue est  caché ou détruit par le programme.*/
	GTK_RESPONSE_NONE = -1,

/* GTK  ne renverra pas ceci à moins que vous les passiez vous-même
* comme réponse à une action sur un widget. Il y a
* pour  votre usage :*/
	GTK_RESPONSE_REJECT = -2,
	GTK_RESPONSE_ACCEPT = -3,

/* Si le dialogue est détruit. */
	GTK_RESPONSE_DELETE_EVENT = -4,
/* Ceux-ci sont retournés par les dialogue GTK, et vous pouvez aussi les utiliser
* vous-même si vous préférez.*/

	GTK_RESPONSE_OK = -5,
	GTK_RESPONSE_CANCEL = -6,
	GTK_RESPONSE_CLOSE = -7,
	GTK_RESPONSE_YES = -8,
	GTK_RESPONSE_NO = -9,
	GTK_RESPONSE_APPLY = -10,
	GTK_RESPONSE_HELP = -11
} GtkResponseType;

gtk_dialog_new ()

GtkWidget* gtk_dialog_new (void);

gtk_dialog_new_with_buttons ()

GtkWidget* gtk_dialog_new_with_buttons (const gchar *title,
	                GtkWindow *parent,
			GtkDialogFlags flags,
			const gchar *first_button_text,
			...);

GtkWidget *dialog = gtk_dialog_new_with_buttons ("Ma boîte de dialogue",
		main_app_window,
		GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
		GTK_STOCK_OK,
		GTK_RESPONSE_ACCEPT,
		GTK_STOCK_CANCEL,
		GTK_RESPONSE_REJECT,
		NULL);

gtk_dialog_run ()

gint gtk_dialog_run (GtkDialog *dialog);

Pendant gtk_dialog_run(), le comportement par défaut de "delete_event" est la désactivation; si le dialogue reçoit  "delete_event", il ne sera pas détruit comme une fenêtre normale, et gtk_dialog_run()  retournera  GTK_RESPONSE_DELETE_EVENT. Aussi, prendant gtk_dialog_run() le dialogue sera modal. Vous pouvez forcer gtk_dialog_run()  à retourner n'importe quand en appelant  gtk_dialog_response()  pour émettre un signal de "réponse". La destruction du dialogue pendant gtk_dialog_run()  est une très mauvaise idée, en effet le code qui sera appelé après ne saura pas si la boîte de dialogue a été détruite ou non.

Après que  gtk_dialog_run() ait retourné, vous pourrez cacher ou détruire le dialogue si vous le souhaitez.

L'untilisation typique de cette fonction doit être :

gint result = gtk_dialog_run (GTK_DIALOG (dialog));
switch (result)
{
case GTK_RESPONSE_ACCEPT:
faire_quelque_chose_specifique_pour_application ();
break;
default:
ne_rien_faire_tant_que_le_dialogue_est_inactif ();
break;
}
gtk_widget_destroy (dialog);

gtk_dialog_response ()

void gtk_dialog_response (GtkDialog *dialog,
			gint response_id);

Emet un signal "réponse" avec un identifiant de réponse donné. Est utilisé pour indiquer que l'utilisateur a répondu au dialogue d'une certaine façon; ensuite soit vous soit   gtk_dialog_run()  gérera le signal de réponse  et prendra les mesures appropriées.

gtk_dialog_add_button ()

GtkWidget* gtk_dialog_add_button (GtkDialog *dialog,
		const gchar *button_text,
		gint response_id);

gtk_dialog_add_buttons ()

void gtk_dialog_add_buttons (GtkDialog *dialog,
		const gchar *first_button_text,
		...);

Ajoute plus de boutons, cette fonction a le même effet que plusieurs appels de gtk_dialog_add_button(). La liste variable d'arguments doit être terminée par  NULL comme pour  gtk_dialog_new_with_buttons(). Chaque bouton doit avoir un texte et un ID de réponse.

gtk_dialog_add_action_widget ()

void gtk_dialog_add_action_widget (GtkDialog *dialog,
		GtkWidget *child,
		gint response_id);

Ajoute un widget activable à la zone d'action de GtkDialog. Cette fonction connecte au traitement de signal qui émettra un signal de "réponse" dans le dialogue quand le  widget sera activé.  Le widget est ajouté à la fin de la zone d'action du dialogue. Si vous voulez un widget non-activable; placez le simplement dans le champs de action_area de  GtkDialog.

gtk_dialog_get_has_separator ()

gboolean gtk_dialog_get_has_separator (GtkDialog *dialog);

gtk_dialog_set_default_response ()

void gtk_dialog_set_default_response (GtkDialog *dialog,
		gint response_id);

gtk_dialog_set_has_separator ()

void gtk_dialog_set_has_separator (GtkDialog *dialog,
		gboolean setting);

Définit si le dialogue a un séparteur au dessus des boutons. TRUE est la valeur par défaut.

gtk_dialog_set_response_sensitive ()

void gtk_dialog_set_response_sensitive (GtkDialog *dialog,
		gint response_id,
		gboolean setting);

gtk_dialog_get_response_for_widget ()

gint gtk_dialog_get_response_for_widget (GtkDialog *dialog,
		GtkWidget *widget);

Récupère l'identifiant de réponse  d'un widget de la zone d'action d'un dialogue.

Depuis 2.8

gtk_alternative_dialog_button_order ()

gboolean gtk_alternative_dialog_button_order (GdkScreen *screen);

Depuis 2.6

gtk_dialog_set_alternative_button_order ()

void gtk_dialog_set_alternative_button_order
		(GtkDialog *dialog,
		gint first_response_id,
		...);

cancel_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
		GTK_STOCK_CANCEL,
		GTK_RESPONSE_CANCEL);
ok_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
		GTK_STOCK_OK,
		GTK_RESPONSE_OK);

gtk_widget_grab_default (ok_button);

help_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
		GTK_STOCK_HELP,
		GTK_RESPONSE_HELP);

gtk_dialog_set_alternative_button_order (GTK_DIALOG (dialog),
		GTK_RESPONSE_OK,
		GTK_RESPONSE_CANCEL,
		GTK_RESPONSE_HELP,
		-1);

Depuis 2.6

gtk_dialog_set_alternative_button_order_from_array ()

void gtk_dialog_set_alternative_button_order_from_array
(GtkDialog *dialog,
gint n_params,
gint *new_order);

Voir gtk_dialog_set_alternative_button_order() pour plus d'informations;

This function is for use by language bindings.

Depuis 2.6