|  |  |  | GNOME UI Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <libgnomeui/libgnomeui.h> GtkWidget * gnome_ok_dialog (const gchar *message); GtkWidget * gnome_ok_dialog_parented (const gchar *message,GtkWindow *parent); GtkWidget * gnome_error_dialog (const gchar *error); GtkWidget * gnome_error_dialog_parented (const gchar *error,GtkWindow *parent); GtkWidget * gnome_warning_dialog (const gchar *warning); GtkWidget * gnome_warning_dialog_parented (const gchar *warning,GtkWindow *parent); GtkWidget * gnome_question_dialog (const gchar *question,GnomeReplyCallback callback,gpointer data); GtkWidget * gnome_question_dialog_parented (const gchar *question,GnomeReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_question_dialog_modal (const gchar *question,GnomeReplyCallback callback,gpointer data); GtkWidget * gnome_question_dialog_modal_parented (const gchar *question,GnomeReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_ok_cancel_dialog (const gchar *message,GnomeReplyCallback callback,gpointer data); GtkWidget * gnome_ok_cancel_dialog_parented (const gchar *message,GnomeReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_ok_cancel_dialog_modal (const gchar *message,GnomeReplyCallback callback,gpointer data); GtkWidget * gnome_ok_cancel_dialog_modal_parented (const gchar *message,GnomeReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_request_string_dialog (const gchar *prompt,GnomeStringCallback callback,gpointer data); GtkWidget * gnome_request_string_dialog_parented (const gchar *prompt,GnomeStringCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_request_password_dialog (const gchar *prompt,GnomeStringCallback callback,gpointer data); GtkWidget * gnome_request_password_dialog_parented (const gchar *prompt,GnomeStringCallback callback,gpointer data,GtkWindow *parent); GtkWidget * gnome_request_dialog (gboolean password,const gchar *prompt,const gchar *default_text,const guint16 max_length,GnomeStringCallback callback,gpointer data,GtkWindow *parent);
GtkWidget *         gnome_ok_dialog                     (const gchar *message);
gnome_ok_dialog is deprecated and should not be used in newly-written code.
Creates and shows a simple message dialog.
| 
 | Message to display | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_ok_dialog_parented (const gchar *message,GtkWindow *parent);
gnome_ok_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a simple message dialog.
| 
 | Message to display | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget *         gnome_error_dialog                  (const gchar *error);
gnome_error_dialog is deprecated and should not be used in newly-written code.
Creates and shows a error dialog. This is an OK dialog to display on fatally failed operations.
| 
 | Message to display | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_error_dialog_parented (const gchar *error,GtkWindow *parent);
gnome_error_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a error dialog. This is an OK dialog to display on fatally failed operations.
| 
 | Message to display | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget *         gnome_warning_dialog                (const gchar *warning);
gnome_warning_dialog is deprecated and should not be used in newly-written code.
Creates and shows a warning dialog. For non-fatal warnings.
| 
 | Message to display | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_warning_dialog_parented (const gchar *warning,GtkWindow *parent);
gnome_warning_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a warning dialog. For non-fatal warnings.
| 
 | Message to display | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_question_dialog (const gchar *question,GnomeReplyCallback callback,gpointer data);
gnome_question_dialog is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Question to ask | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_question_dialog_parented (const gchar *question,GnomeReplyCallback callback,gpointer data,GtkWindow *parent);
gnome_question_dialog_parented is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Question to ask | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_question_dialog_modal (const gchar *question,GnomeReplyCallback callback,gpointer data);
gnome_question_dialog_modal is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Question to ask | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_question_dialog_modal_parented (const gchar *question,GnomeReplyCallback callback,gpointer data,GtkWindow *parent);
gnome_question_dialog_modal_parented is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Question to ask | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_ok_cancel_dialog (const gchar *message,GnomeReplyCallback callback,gpointer data);
gnome_ok_cancel_dialog is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Message to display | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_ok_cancel_dialog_parented (const gchar *message,GnomeReplyCallback callback,gpointer data,GtkWindow *parent);
gnome_ok_cancel_dialog_parented is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Message to display | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_ok_cancel_dialog_modal (const gchar *message,GnomeReplyCallback callback,gpointer data);
gnome_ok_cancel_dialog_modal is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Message to display | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_ok_cancel_dialog_modal_parented (const gchar *message,GnomeReplyCallback callback,gpointer data,GtkWindow *parent);
gnome_ok_cancel_dialog_modal_parented is deprecated and should not be used in newly-written code.
Creates and shows an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* GnomeReplyCallback)(gint reply, gpointer data);
| 
 | Message to display | 
| 
 | Callback function for handling dialog results | 
| 
 | Data to pass to callback | 
| 
 | Parent window | 
| Returns : | Pointer to new GNOME dialog object. | 
GtkWidget * gnome_request_string_dialog (const gchar *prompt,GnomeStringCallback callback,gpointer data);
gnome_request_string_dialog is deprecated and should not be used in newly-written code.
Deprecated, use gnome_request_dialog
GtkWidget * gnome_request_string_dialog_parented (const gchar *prompt,GnomeStringCallback callback,gpointer data,GtkWindow *parent);
gnome_request_string_dialog_parented is deprecated and should not be used in newly-written code.
Deprecated, use gnome_request_dialog
GtkWidget * gnome_request_password_dialog (const gchar *prompt,GnomeStringCallback callback,gpointer data);
gnome_request_password_dialog is deprecated and should not be used in newly-written code.
Deprecated, use gnome_request_dialog instead.
GtkWidget * gnome_request_password_dialog_parented (const gchar *prompt,GnomeStringCallback callback,gpointer data,GtkWindow *parent);
gnome_request_password_dialog_parented is deprecated and should not be used in newly-written code.
Deprecated, use gnome_request_dialog.
GtkWidget * gnome_request_dialog (gboolean password,const gchar *prompt,const gchar *default_text,const guint16 max_length,GnomeStringCallback callback,gpointer data,GtkWindow *parent);
gnome_request_dialog is deprecated and should not be used in newly-written code.
Creates and shows a GNOME text entry request dialog.
callback is called when the dialog closes, passing the text entry
input or NULL if the user cancelled.  callback is defined as
void (* GnomeStringCallback)(gchar * string, gpointer data);
| 
 | TRUEif on-screen text input is masked | 
| 
 | Text of the prompt to be displayed | 
| 
 | Default text in entry widget, NULLif none | 
| 
 | Maximum input chars allowed | 
| 
 | Callback function for handling dialog results | 
| 
 | Data passed to the callback | 
| 
 | Parent window, or NULLfor no parent. | 
| Returns : | Pointer to new GNOME dialog object. |