gnome-dialog-util

Name

gnome-dialog-util — Convenience functions for making dialogs.

Synopsis


#include <gnome.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);

Description

These functions create common dialogs for you. In all cases, you should prefer the _parented() variants, because they will properly call gnome_dialog_set_parent() prior to showing the dialog. All of these functions automatically show the dialog before they return.

Details

gnome_ok_dialog ()

GtkWidget*  gnome_ok_dialog                 (const gchar *message);

message : 
Returns : 


gnome_ok_dialog_parented ()

GtkWidget*  gnome_ok_dialog_parented        (const gchar *message,
                                             GtkWindow *parent);

message : 
parent : 
Returns : 


gnome_error_dialog ()

GtkWidget*  gnome_error_dialog              (const gchar *error);

error : 
Returns : 


gnome_error_dialog_parented ()

GtkWidget*  gnome_error_dialog_parented     (const gchar *error,
                                             GtkWindow *parent);

error : 
parent : 
Returns : 


gnome_warning_dialog ()

GtkWidget*  gnome_warning_dialog            (const gchar *warning);

warning : 
Returns : 


gnome_warning_dialog_parented ()

GtkWidget*  gnome_warning_dialog_parented   (const gchar *warning,
                                             GtkWindow *parent);

warning : 
parent : 
Returns : 


gnome_question_dialog ()

GtkWidget*  gnome_question_dialog           (const gchar *question,
                                             GnomeReplyCallback callback,
                                             gpointer data);

question : 
callback : 
data : 
Returns : 


gnome_question_dialog_parented ()

GtkWidget*  gnome_question_dialog_parented  (const gchar *question,
                                             GnomeReplyCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

question : 
callback : 
data : 
parent : 
Returns : 


gnome_question_dialog_modal ()

GtkWidget*  gnome_question_dialog_modal     (const gchar *question,
                                             GnomeReplyCallback callback,
                                             gpointer data);

question : 
callback : 
data : 
Returns : 


gnome_question_dialog_modal_parented ()

GtkWidget*  gnome_question_dialog_modal_parented
                                            (const gchar *question,
                                             GnomeReplyCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

question : 
callback : 
data : 
parent : 
Returns : 


gnome_ok_cancel_dialog ()

GtkWidget*  gnome_ok_cancel_dialog          (const gchar *message,
                                             GnomeReplyCallback callback,
                                             gpointer data);

message : 
callback : 
data : 
Returns : 


gnome_ok_cancel_dialog_parented ()

GtkWidget*  gnome_ok_cancel_dialog_parented (const gchar *message,
                                             GnomeReplyCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

message : 
callback : 
data : 
parent : 
Returns : 


gnome_ok_cancel_dialog_modal ()

GtkWidget*  gnome_ok_cancel_dialog_modal    (const gchar *message,
                                             GnomeReplyCallback callback,
                                             gpointer data);

message : 
callback : 
data : 
Returns : 


gnome_ok_cancel_dialog_modal_parented ()

GtkWidget*  gnome_ok_cancel_dialog_modal_parented
                                            (const gchar *message,
                                             GnomeReplyCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

message : 
callback : 
data : 
parent : 
Returns : 


gnome_request_string_dialog ()

GtkWidget*  gnome_request_string_dialog     (const gchar *prompt,
                                             GnomeStringCallback callback,
                                             gpointer data);

prompt : 
callback : 
data : 
Returns : 


gnome_request_string_dialog_parented ()

GtkWidget*  gnome_request_string_dialog_parented
                                            (const gchar *prompt,
                                             GnomeStringCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

prompt : 
callback : 
data : 
parent : 
Returns : 


gnome_request_password_dialog ()

GtkWidget*  gnome_request_password_dialog   (const gchar *prompt,
                                             GnomeStringCallback callback,
                                             gpointer data);

prompt : 
callback : 
data : 
Returns : 


gnome_request_password_dialog_parented ()

GtkWidget*  gnome_request_password_dialog_parented
                                            (const gchar *prompt,
                                             GnomeStringCallback callback,
                                             gpointer data,
                                             GtkWindow *parent);

prompt : 
callback : 
data : 
parent : 
Returns : 


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);

Creates 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);

password : TRUE if on-screen text input is masked
prompt : Text of the prompt to be displayed
default_text : Default text in entry widget, NULL if none
max_length : Maximum input chars allowed
callback : Callback function for handling dialog results
data : 
parent : Parent window, or NULL for no parent.
Returns : Pointer to new GNOME dialog object.