Name
GnomeMessageBox -- Message box display routines
Object Hierarchy
GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBin
+----GtkWindow
+----GnomeDialog
+----GnomeMessageBox |
Description
The GnomeMessageBox widget creates dialog boxes (of type
GnomeDialog) that contain a severity level (indicated by an icon
and a title), a message to be displayed and a list of buttons that
will be in the dialog.
The programmer will use strings desired for each button. If the
strings are any of the GNOME_STOCK macros, then instead of
creating a button with the text, the button will be a GNOME stock
button with a stock icon.
The list of known types for message boxes are:
GNOME_MESSAGE_BOX_INFO, GNOME_MESSAGE_BOX_WARNING,
GNOME_MESSAGE_BOX_ERROR, GNOME_MESSAGE_BOX_QUESTION and
GNOME_MESSAGE_BOX_GENERIC.
Here is an example that informs the user of an error:
GtkWidget *error_dialog;
int ret;
error_dialog = gnome_message_box_new (
"Wrong password",
GNOME_MESSAGE_BOX_ERROR,
"Retry", "Ignore",
NULL);
ret = gnome_dialog_run (GNOME_DIALOG (error_dialog));
switch (ret){
case 0:
do_retry();
break;
case 1:
do_ignore()
break;
default:
/* User closed dialog with window manager,
* assume "ignore"
*/
do_ignore();
break;
}
|
This other example uses stock buttons:
GtkWidget *yes_no_dialog;
int ret;
yes_no_dialog = gnome_message_box_new (
"Do you want to make a chocolate cake?",
GNOME_MESSAGE_BOX_QUESTION,
GNOME_STOCK_BUTTON_YES,
GNOME_STOCK_BUTTON_NO,
NULL);
ret = gnome_dialog_run (GNOME_DIALOG (yes_no_dialog));
switch (ret){
case 0:
make_chocolate_cake();
break;
case 1:
/* User does not desire chocolate cake *./
break;
default:
/*
* User closed dialog with window manager,
* assume he is not into chocolate cake.
*/
do_ignore();
break;
}
|
Details
GNOME_MESSAGE_BOX_INFO
#define GNOME_MESSAGE_BOX_INFO "info" |
Use this macro for displaying an informational message.
GNOME_MESSAGE_BOX_WARNING
#define GNOME_MESSAGE_BOX_WARNING "warning" |
Use this macro for displaying a warning message.
GNOME_MESSAGE_BOX_ERROR
#define GNOME_MESSAGE_BOX_ERROR "error" |
Use this macro for displaying an error message.
GNOME_MESSAGE_BOX_QUESTION
#define GNOME_MESSAGE_BOX_QUESTION "question" |
Use this macro when you want to query the user for information.
GNOME_MESSAGE_BOX_GENERIC
#define GNOME_MESSAGE_BOX_GENERIC "generic" |
Use this macro if none of the other message box types apply.
struct GnomeMessageBoxButton
struct GnomeMessageBoxButton; |
gnome_message_box_new ()
GtkWidget* gnome_message_box_new (const gchar *message,
const gchar *messagebox_type,
...); |
Creates a dialog box of type message_box_type with message. A number
of buttons are inserted on it. You can use the GNOME stock identifiers
to create gnome-stock-buttons.
gnome_message_box_newv ()
GtkWidget* gnome_message_box_newv (const gchar *message,
const gchar *messagebox_type,
const gchar **buttons); |
Creates a dialog box of type message_box_type with message. A number
of buttons are inserted on it, the messages come from the buttons array.
You can use the GNOME stock identifiers to create gnome-stock-buttons.
gnome_message_box_set_modal ()
Deprecated. Use gtk_window_set_modal().
gnome_message_box_set_default ()
void gnome_message_box_set_default (GnomeMessageBox *messagebox,
gint button); |
Deprecated. Use gnome_dialog_set_modal().