Dialog Window Functions (Legacy)

Dialog Window Functions (Legacy)

Synopsis

void                e_notice                            (gpointer parent,
                                                         GtkMessageType type,
                                                         const gchar *format,
                                                         ...);
gchar *             e_file_dialog_save                  (GtkWindow *parent,
                                                         const gchar *title,
                                                         const gchar *fname);
GtkWidget *         e_file_get_save_filesel             (GtkWindow *parent,
                                                         const gchar *title,
                                                         const gchar *name,
                                                         GtkFileChooserAction action);
gboolean            e_file_can_save                     (GtkWindow *parent,
                                                         const gchar *uri);
gboolean            e_file_check_local                  (const gchar *name);
void                e_dialog_editable_set               (GtkWidget *widget,
                                                         const gchar *value);
gchar *             e_dialog_editable_get               (GtkWidget *widget);
void                e_dialog_combo_box_set              (GtkWidget *widget,
                                                         gint value,
                                                         const gint *value_map);
gint                e_dialog_combo_box_get              (GtkWidget *widget,
                                                         const gint *value_map);

Description

Details

e_notice ()

void                e_notice                            (gpointer parent,
                                                         GtkMessageType type,
                                                         const gchar *format,
                                                         ...);

Convenience function to show a dialog with a message and an "OK" button.

parent :

the dialog's parent window, or NULL

type :

the type of dialog (GTK_MESSAGE_INFO, GTK_MESSAGE_WARNING, or GTK_MESSAGE_ERROR)

format :

printf-style format string, followed by arguments

... :


e_file_dialog_save ()

gchar *             e_file_dialog_save                  (GtkWindow *parent,
                                                         const gchar *title,
                                                         const gchar *fname);

parent :

title :

fname :

Returns :


e_file_get_save_filesel ()

GtkWidget *         e_file_get_save_filesel             (GtkWindow *parent,
                                                         const gchar *title,
                                                         const gchar *name,
                                                         GtkFileChooserAction action);

Creates a save dialog, using the saved directory from gconf. The dialog has no signals connected and is not shown.

parent :

parent window

title :

dialog title

name :

filename; already in a proper form (suitable for file system)

action :

action for dialog

Returns :


e_file_can_save ()

gboolean            e_file_can_save                     (GtkWindow *parent,
                                                         const gchar *uri);

Return TRUE if the URI can be saved to, FALSE otherwise. It checks local files to see if they're regular and can be accessed. If the file exists and is writable, it pops up a dialog asking the user if they want to overwrite it. Returns the users choice.

parent :

uri :

Returns :


e_file_check_local ()

gboolean            e_file_check_local                  (const gchar *name);

name :

Returns :


e_dialog_editable_set ()

void                e_dialog_editable_set               (GtkWidget *widget,
                                                         const gchar *value);

Sets the string value inside a GtkEditable-derived widget.

widget :

A GtkEditable widget.

value :

String value.

e_dialog_editable_get ()

gchar *             e_dialog_editable_get               (GtkWidget *widget);

Queries the string value inside a GtkEditable-derived widget.

widget :

A GtkEditable widget.

Returns :

String value. You should free it when you are done with it. This function can return NULL if the string could not be converted from GTK+'s encoding into UTF8.

e_dialog_combo_box_set ()

void                e_dialog_combo_box_set              (GtkWidget *widget,
                                                         gint value,
                                                         const gint *value_map);

Sets the selected item in a GtkComboBox. Please read the description of e_dialog_radio_set() to see how value_map maps enumeration values to item indices.

widget :

A GtkComboBox.

value :

Enumerated value.

value_map :

Map from enumeration values to array indices.

e_dialog_combo_box_get ()

gint                e_dialog_combo_box_get              (GtkWidget *widget,
                                                         const gint *value_map);

Queries the selected item in a GtkComboBox. Please read the description of e_dialog_radio_set() to see how value_map maps enumeration values to item indices.

widget :

A GtkComboBox.

value_map :

Map from enumeration values to array indices.

Returns :

Enumeration value which corresponds to the selected item in the combo box.