cong-error-dialog

cong-error-dialog

Functions

Types and Values

Description

Functions

cong_error_dialog_new ()

GtkDialog *
cong_error_dialog_new (GtkWindow *parent_window,
                       const gchar *what_failed,
                       const gchar *why_failed,
                       const gchar *suggestions);

TODO: Write me


cong_error_dialog_new_with_convenience ()

GtkDialog *
cong_error_dialog_new_with_convenience
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                const gchar *why_failed,
                                const gchar *suggestions,
                                const gchar *convenience_label,
                                const gchar *cancel_label,
                                gboolean is_convenience_default,
                                void (*convenience_action) (gpointer data),
                                gpointer convenience_data);

Use this function to create a dialog, that will report user about error and suggest a way, how user can avoid those error. It is more preferable to report about errors with this function, rather than with cong_error_dialog_new.

Parameters

parent_window

Parent window for dialog.

 

what_failed

The description of what failed

 

why_failed

The reasons of failture

 

suggestions

The suggestions for user.

 

convenience_label

Label or gtk stock for convenience button.

 

cancel_label

Label or gtk stock for cancel button.

 

is_convenience_default

Should the convenience action be the default response.

 

convenience_action

Callback to call on convenience response.

 

convenience_data

Data to pass to the callback.

 

Returns

Dialog widget that should be passed to cong_error_dialog_run.


cong_error_dialog_run ()

void
cong_error_dialog_run (GtkDialog *dialog);

TODO: Write me


cong_error_dialog_do ()

void
cong_error_dialog_do (GtkDialog *dialog);

TODO: Write me


cong_error_get_appname ()

gchar *
cong_error_get_appname (void);

Returns

a string containing "Conglomerate"


cong_error_dialog_new_from_unimplemented_feature ()

GtkDialog *
cong_error_dialog_new_from_unimplemented_feature
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                const char *filename,
                                int linenum);

TODO: Write me


cong_error_dialog_new_from_unimplemented_feature_with_bugzilla_id ()

GtkDialog *
cong_error_dialog_new_from_unimplemented_feature_with_bugzilla_id
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                const char *filename,
                                int linenum,
                                const gchar *bugzilla_url,
                                int bugzilla_id);

TODO: Write me


CONG_DO_UNIMPLEMENTED_DIALOG()

#define CONG_DO_UNIMPLEMENTED_DIALOG(parent_window, what_failed) (cong_error_dialog_do(cong_error_dialog_new_from_unimplemented_feature((parent_window), (what_failed), __FILE__, __LINE__)))


CONG_DO_UNIMPLEMENTED_DIALOG_WITH_BUGZILLA_ID()

#define CONG_DO_UNIMPLEMENTED_DIALOG_WITH_BUGZILLA_ID(parent_window, what_failed, bugzilla_id) (cong_error_dialog_do(cong_error_dialog_new_from_unimplemented_feature_with_bugzilla_id((parent_window), (what_failed), __FILE__, __LINE__, CONG_BUGZILLA_URL, (bugzilla_id))))


cong_error_dialog_new_from_gerror ()

GtkDialog *
cong_error_dialog_new_from_gerror (GtkWindow *toplevel_window,
                                   const gchar *what_failed,
                                   const char *details,
                                   GError *error);

TODO: Write me


cong_error_dialog_new_from_shell_command_failure_with_command_line ()

GtkDialog *
cong_error_dialog_new_from_shell_command_failure_with_command_line
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                gint exit_status,
                                const gchar *standard_error,
                                const gchar *command_line);

TODO: Write me


cong_error_dialog_new_from_shell_command_failure_with_argv ()

GtkDialog *
cong_error_dialog_new_from_shell_command_failure_with_argv
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                gint exit_status,
                                const gchar *standard_error,
                                const gchar **argv);

Routine to manufacture an error dialog for when some shell operation fails, when you have access to the stderr output in the form of a string. argv is a NULL terminated array of strings.


cong_error_what_failed_on_file_open_failure ()

gchar *
cong_error_what_failed_on_file_open_failure
                               (const gchar *string_uri,
                                gboolean transient);

TODO: Write me


cong_error_dialog_new_from_file_open_failure ()

GtkDialog *
cong_error_dialog_new_from_file_open_failure
                               (GtkWindow *parent_window,
                                const gchar *string_uri,
                                gboolean transient,
                                const gchar *why_failed,
                                const gchar *suggestions);

TODO: Write me


cong_error_dialog_new_from_file_open_failure_with_convenience ()

GtkDialog *
cong_error_dialog_new_from_file_open_failure_with_convenience
                               (GtkWindow *parent_window,
                                const gchar *string_uri,
                                gboolean transient,
                                const gchar *why_failed,
                                const gchar *suggestions,
                                const gchar *convenience_label,
                                void (*convenience_action) (gpointer data),
                                gpointer convenience_data);

TODO: Write me


cong_error_dialog_new_from_file_open_failure_with_vfs_result ()

GtkDialog *
cong_error_dialog_new_from_file_open_failure_with_vfs_result
                               (GtkWindow *parent_window,
                                const gchar *string_uri,
                                GnomeVFSResult vfs_result);

TODO: Write me


cong_error_dialog_new_from_file_save_failure ()

GtkDialog *
cong_error_dialog_new_from_file_save_failure
                               (GtkWindow *parent_window,
                                const gchar *string_uri,
                                GnomeVFSResult vfs_result,
                                const GnomeVFSFileSize *file_size);

TODO: Write me


cong_error_dialog_new_from_file_operation_failure ()

GtkDialog *
cong_error_dialog_new_from_file_operation_failure
                               (GtkWindow *parent_window,
                                const gchar *what_failed,
                                const gchar *string_uri,
                                GnomeVFSResult vfs_result,
                                const gchar *technical_details);

Routine to manufacture an error dialog for when some file operation fails that doesn't fall into one of the categories above. Displays what operation has failed, with a convenience button to get more techical information.

Parameters

string_uri

the URI from which you tried to access file.

 

cong_error_tests ()

void
cong_error_tests (GtkWindow *parent_window);

TODO: Write me

Types and Values

CONG_BUGZILLA_URL

#define CONG_BUGZILLA_URL ("http://bugzilla.gnome.org")