## Dialog Utilities (Legacy)

Dialog Utilities (Legacy)

## Synopsis

    void                e_notice                            (gpointer parent,
                                                             GtkMessageType type,
                                                             const gchar *format,
                                                             ...);
    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_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.