gnome-dialog-util

gnome-dialog-util

Functions

Includes

#include <libgnomeui/libgnomeui.h>

Description

Functions

gnome_ok_dialog ()

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.

Parameters

message

Message to display

 

Returns

Pointer to new GNOME dialog object.


gnome_ok_dialog_parented ()

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.

Parameters

message

Message to display

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_error_dialog ()

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.

Parameters

error

Message to display

 

Returns

Pointer to new GNOME dialog object.


gnome_error_dialog_parented ()

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.

Parameters

error

Message to display

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_warning_dialog ()

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.

Parameters

warning

Message to display

 

Returns

Pointer to new GNOME dialog object.


gnome_warning_dialog_parented ()

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.

Parameters

warning

Message to display

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_question_dialog ()

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

Parameters

question

Question to ask

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

Returns

Pointer to new GNOME dialog object.


gnome_question_dialog_parented ()

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

Parameters

question

Question to ask

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_question_dialog_modal ()

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

Parameters

question

Question to ask

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

Returns

Pointer to new GNOME dialog object.


gnome_question_dialog_modal_parented ()

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

Parameters

question

Question to ask

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_ok_cancel_dialog ()

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

Parameters

message

Message to display

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

Returns

Pointer to new GNOME dialog object.


gnome_ok_cancel_dialog_parented ()

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

Parameters

message

Message to display

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_ok_cancel_dialog_modal ()

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

Parameters

message

Message to display

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

Returns

Pointer to new GNOME dialog object.


gnome_ok_cancel_dialog_modal_parented ()

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

Parameters

message

Message to display

 

callback

Callback function for handling dialog results

 

data

Data to pass to callback

 

parent

Parent window

 

Returns

Pointer to new GNOME dialog object.


gnome_request_string_dialog ()

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


gnome_request_string_dialog_parented ()

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


gnome_request_password_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.


gnome_request_password_dialog_parented ()

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.


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

Parameters

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

Data passed to the callback

 

parent

Parent window, or NULL for no parent.

 

Returns

Pointer to new GNOME dialog object.

Types and Values