MateDialog

## MateDialog MateDialog — Create generic dialog boxes. |

## Synopsis

    #include <libmateui/libmateui.h>

    struct              MateDialog;
    GtkWidget *         mate_dialog_new                    (const gchar *title,
                                                             ...);
    GtkWidget *         mate_dialog_newv                   (const gchar *title,
                                                             const gchar **buttons);
    void                mate_dialog_set_parent             (MateDialog *dialog,
                                                             GtkWindow *parent);
    void                mate_dialog_button_connect         (MateDialog *dialog,
                                                             gint button,
                                                             GCallback callback,
                                                             gpointer data);
    void                mate_dialog_button_connect_object  (MateDialog *dialog,
                                                             gint button,
                                                             GCallback callback,
                                                             GtkObject *obj);
    gint                mate_dialog_run                    (MateDialog *dialog);
    gint                mate_dialog_run_and_close          (MateDialog *dialog);
    void                mate_dialog_set_default            (MateDialog *dialog,
                                                             gint button);
    void                mate_dialog_grab_focus             (MateDialog *dialog,
                                                             gint button);
    void                mate_dialog_set_sensitive          (MateDialog *dialog,
                                                             gint button,
                                                             gboolean setting);
    void                mate_dialog_set_accelerator        (MateDialog *dialog,
                                                             gint button,
                                                             const guchar accelerator_key,
                                                             guint8 accelerator_mods);
    void                mate_dialog_close                  (MateDialog *dialog);
    void                mate_dialog_close_hides            (MateDialog *dialog,
                                                             gboolean just_hide);
    void                mate_dialog_set_close              (MateDialog *dialog,
                                                             gboolean click_closes);
    void                mate_dialog_editable_enters        (MateDialog *dialog,
                                                             GtkEditable *editable);
    void                mate_dialog_append_buttons         (MateDialog *dialog,
                                                             const gchar *first,
                                                             ...);
    void                mate_dialog_append_button          (MateDialog *dialog,
                                                             const gchar *button_name);
    void                mate_dialog_append_buttonsv        (MateDialog *dialog,
                                                             const gchar **buttons);
    void                mate_dialog_append_button_with_pixmap
                                                            (MateDialog *dialog,
                                                             const gchar *button_name,
                                                             const gchar *pixmap_name);
    void                mate_dialog_append_buttons_with_pixmaps
                                                            (MateDialog *dialog,
                                                             const gchar **names,
                                                             const gchar **pixmaps);
    void                mate_dialog_construct              (MateDialog *dialog,
                                                             const gchar *title,
                                                             va_list ap);
    void                mate_dialog_constructv             (MateDialog *dialog,
                                                             const gchar *title,
                                                             const gchar **buttons);
    #define             MATE_STOCK_BUTTON_OK
    #define             MATE_STOCK_BUTTON_CANCEL
    #define             MATE_STOCK_BUTTON_YES
    #define             MATE_STOCK_BUTTON_NO
    #define             MATE_STOCK_BUTTON_CLOSE
    #define             MATE_STOCK_BUTTON_APPLY
    #define             MATE_STOCK_BUTTON_HELP
    #define             MATE_STOCK_BUTTON_NEXT
    #define             MATE_STOCK_BUTTON_PREV
    #define             MATE_STOCK_BUTTON_UP
    #define             MATE_STOCK_BUTTON_DOWN
    #define             MATE_STOCK_BUTTON_FONT

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----MateDialog
                                                 +----MateMessageBox
                                                 +----MatePropertyBox

## Implemented Interfaces

MateDialog implements AtkImplementorIface and GtkBuildable.

## Signals

      "clicked"                                        : Run Last
      "close"                                          : Run Last

## Description

## Details

### struct MateDialog

    struct MateDialog {
      GtkWidget * vbox;
    };

### Warning

`MateDialog` is deprecated and should not be used in newly-written code.

Client code can pack widgets (for example, text or images) into `vbox`.

GtkWidget *`vbox`; | The middle portion of the dialog box.

### mate_dialog_new ()

    GtkWidget *         mate_dialog_new                    (const gchar *title,
                                                             ...);

### Warning

`mate_dialog_new` is deprecated and should not be used in newly-written code.

`title` : |
`...` : |
Returns : |

### mate_dialog_newv ()

    GtkWidget *         mate_dialog_newv                   (const gchar *title,
                                                             const gchar **buttons);

### Warning

`mate_dialog_newv` is deprecated and should not be used in newly-written code.

`title` : |
`buttons` : |
Returns : |

### mate_dialog_set_parent ()

    void                mate_dialog_set_parent             (MateDialog *dialog,
                                                             GtkWindow *parent);

### Warning

`mate_dialog_set_parent` is deprecated and should not be used in newly-written code.

`dialog` : |
`parent` : |

### mate_dialog_button_connect ()

    void                mate_dialog_button_connect         (MateDialog *dialog,
                                                             gint button,
                                                             GCallback callback,
                                                             gpointer data);

### Warning

`mate_dialog_button_connect` is deprecated and should not be used in newly-written code.

`dialog` : |
`button` : |
`callback` : |
`data` : |

### mate_dialog_button_connect_object ()

    void                mate_dialog_button_connect_object  (MateDialog *dialog,
                                                             gint button,
                                                             GCallback callback,
                                                             GtkObject *obj);

### Warning

`mate_dialog_button_connect_object` is deprecated and should not be used in newly-written code.

`dialog` : |
`button` : |
`callback` : |
`obj` : |

### mate_dialog_run ()

    gint                mate_dialog_run                    (MateDialog *dialog);

### Warning

`mate_dialog_run` is deprecated and should not be used in newly-written code.

`dialog` : |
Returns : |

### mate_dialog_run_and_close ()

    gint                mate_dialog_run_and_close          (MateDialog *dialog);

### Warning

`mate_dialog_run_and_close` is deprecated and should not be used in newly-written code.

`dialog` : |
Returns : |

### mate_dialog_set_default ()

    void                mate_dialog_set_default            (MateDialog *dialog,
                                                             gint button);

### Warning

`mate_dialog_set_default` is deprecated and should not be used in newly-written code.

`dialog` : |
`button` : |

### mate_dialog_grab_focus ()

    void                mate_dialog_grab_focus             (MateDialog *dialog,
                                                             gint button);

### Warning

`mate_dialog_grab_focus` is deprecated and should not be used in newly-written code.

`dialog` : |
`button` : |

### mate_dialog_set_sensitive ()

    void                mate_dialog_set_sensitive          (MateDialog *dialog,
                                                             gint button,
                                                             gboolean setting);

### Warning

`mate_dialog_set_sensitive` is deprecated and should not be used in newly-written code.

`dialog` : |
`button` : |
`setting` : |

### mate_dialog_set_accelerator ()

    void                mate_dialog_set_accelerator        (MateDialog *dialog,
                                                             gint button,
                                                             const guchar accelerator_key,
                                                             guint8 accelerator_mods);

### Warning

`mate_dialog_set_accelerator` is deprecated and should not be used in newly-written code.

Set an accelerator key for a button.

`dialog` : | MateDialog to affect.
`button` : | Button number.
`accelerator_key` : | Key for the accelerator.
`accelerator_mods` : | Modifier.

### mate_dialog_close ()

    void                mate_dialog_close                  (MateDialog *dialog);

### Warning

`mate_dialog_close` is deprecated and should not be used in newly-written code.

`dialog` : |

### mate_dialog_close_hides ()

    void                mate_dialog_close_hides            (MateDialog *dialog,
                                                             gboolean just_hide);

### Warning

`mate_dialog_close_hides` is deprecated and should not be used in newly-written code.

`dialog` : |
`just_hide` : |

### mate_dialog_set_close ()

    void                mate_dialog_set_close              (MateDialog *dialog,
                                                             gboolean click_closes);

### Warning

`mate_dialog_set_close` is deprecated and should not be used in newly-written code.

`dialog` : |
`click_closes` : |

### mate_dialog_editable_enters ()

    void                mate_dialog_editable_enters        (MateDialog *dialog,
                                                             GtkEditable *editable);

### Warning

`mate_dialog_editable_enters` is deprecated and should not be used in newly-written code.

`dialog` : |
`editable` : |

### mate_dialog_append_buttons ()

    void                mate_dialog_append_buttons         (MateDialog *dialog,
                                                             const gchar *first,
                                                             ...);

### Warning

`mate_dialog_append_buttons` is deprecated and should not be used in newly-written code.

`dialog` : |
`first` : |
`...` : |

### mate_dialog_append_button ()

    void                mate_dialog_append_button          (MateDialog *dialog,
                                                             const gchar *button_name);

### Warning

`mate_dialog_append_button` is deprecated and should not be used in newly-written code.

Add a button to a dialog after its initial construction. This function is mostly for internal library use. You should use `mate_dialog_new()` instead. See that function for a description of the button argument.

`dialog` : | MateDialog to add button to.
`button_name` : | Button to add.

### mate_dialog_append_buttonsv ()

    void                mate_dialog_append_buttonsv        (MateDialog *dialog,
                                                             const gchar **buttons);

### Warning

`mate_dialog_append_buttonsv` is deprecated and should not be used in newly-written code.

`dialog` : |
`buttons` : |

### mate_dialog_append_button_with_pixmap ()

    void                mate_dialog_append_button_with_pixmap
                                                            (MateDialog *dialog,
                                                             const gchar *button_name,
                                                             const gchar *pixmap_name);

### Warning

`mate_dialog_append_button_with_pixmap` is deprecated and should not be used in newly-written code.

Add a pixmap button to a dialog. `mate_dialog_new()` does not permit custom buttons with pixmaps, so if you want one of those you need to use this function.

`dialog` : | MateDialog to add the button to.
`button_name` : | Name of the button, or stock button #define.
`pixmap_name` : | Stock pixmap name.

### mate_dialog_append_buttons_with_pixmaps ()

    void                mate_dialog_append_buttons_with_pixmaps
                                                            (MateDialog *dialog,
                                                             const gchar **names,
                                                             const gchar **pixmaps);

### Warning

`mate_dialog_append_buttons_with_pixmaps` is deprecated and should not be used in newly-written code.

`dialog` : |
`names` : |
`pixmaps` : |

### mate_dialog_construct ()

    void                mate_dialog_construct              (MateDialog *dialog,
                                                             const gchar *title,
                                                             va_list ap);

### Warning

`mate_dialog_construct` is deprecated and should not be used in newly-written code.

`dialog` : |
`title` : |
`ap` : |

### mate_dialog_constructv ()

    void                mate_dialog_constructv             (MateDialog *dialog,
                                                             const gchar *title,
                                                             const gchar **buttons);

### Warning

`mate_dialog_constructv` is deprecated and should not be used in newly-written code.

`dialog` : |
`title` : |
`buttons` : |

### MATE_STOCK_BUTTON_OK

    #define MATE_STOCK_BUTTON_OK     GTK_STOCK_OK

### Warning

`MATE_STOCK_BUTTON_OK` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_CANCEL

    #define MATE_STOCK_BUTTON_CANCEL GTK_STOCK_CANCEL

### Warning

`MATE_STOCK_BUTTON_CANCEL` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_YES

    #define MATE_STOCK_BUTTON_YES    GTK_STOCK_YES

### Warning

`MATE_STOCK_BUTTON_YES` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_NO

    #define MATE_STOCK_BUTTON_NO     GTK_STOCK_NO

### Warning

`MATE_STOCK_BUTTON_NO` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_CLOSE

    #define MATE_STOCK_BUTTON_CLOSE  GTK_STOCK_CLOSE

### Warning

`MATE_STOCK_BUTTON_CLOSE` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_APPLY

    #define MATE_STOCK_BUTTON_APPLY  GTK_STOCK_APPLY

### Warning

`MATE_STOCK_BUTTON_APPLY` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_HELP

    #define MATE_STOCK_BUTTON_HELP   GTK_STOCK_HELP

### Warning

`MATE_STOCK_BUTTON_HELP` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_NEXT

    #define MATE_STOCK_BUTTON_NEXT   GTK_STOCK_GO_FORWARD

### Warning

`MATE_STOCK_BUTTON_NEXT` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_PREV

    #define MATE_STOCK_BUTTON_PREV   GTK_STOCK_GO_BACK

### Warning

`MATE_STOCK_BUTTON_PREV` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_UP

    #define MATE_STOCK_BUTTON_UP     GTK_STOCK_GO_UP

### Warning

`MATE_STOCK_BUTTON_UP` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_DOWN

    #define MATE_STOCK_BUTTON_DOWN   GTK_STOCK_GO_DOWN

### Warning

`MATE_STOCK_BUTTON_DOWN` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

### MATE_STOCK_BUTTON_FONT

    #define MATE_STOCK_BUTTON_FONT   GTK_STOCK_SELECT_FONT

### Warning

`MATE_STOCK_BUTTON_FONT` is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

## Signal Details

### The `"clicked"` signal

    void                user_function                      (MateDialog *dialog,
                                                            gint         arg1,
                                                            gpointer     user_data)      : Run Last

`dialog` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"close"` signal

    gboolean            user_function                      (MateDialog *dialog,
                                                            gpointer     user_data)      : Run Last

`dialog` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.
Returns : |