mate-app-util

## mate-app-util mate-app-util |

## Synopsis

    #include <libmateui/libmateui.h>

    GtkWidget *         mate_app_message                   (MateApp *app,
                                                             const gchar *message);
    void                mate_app_flash                     (MateApp *app,
                                                             const gchar *flash);
    GtkWidget *         mate_app_error                     (MateApp *app,
                                                             const gchar *error);
    GtkWidget *         mate_app_warning                   (MateApp *app,
                                                             const gchar *warning);
    GtkWidget *         mate_app_question                  (MateApp *app,
                                                             const gchar *question,
                                                             MateReplyCallback callback,
                                                             gpointer data);
    GtkWidget *         mate_app_question_modal            (MateApp *app,
                                                             const gchar *question,
                                                             MateReplyCallback callback,
                                                             gpointer data);
    GtkWidget *         mate_app_ok_cancel                 (MateApp *app,
                                                             const gchar *message,
                                                             MateReplyCallback callback,
                                                             gpointer data);
    GtkWidget *         mate_app_ok_cancel_modal           (MateApp *app,
                                                             const gchar *message,
                                                             MateReplyCallback callback,
                                                             gpointer data);
    GtkWidget *         mate_app_request_string            (MateApp *app,
                                                             const gchar *prompt,
                                                             MateStringCallback callback,
                                                             gpointer data);
    GtkWidget *         mate_app_request_password          (MateApp *app,
                                                             const gchar *prompt,
                                                             MateStringCallback callback,
                                                             gpointer data);
    gdouble             (*MateAppProgressFunc)             (gpointer data);
    void                (*MateAppProgressCancelFunc)       (gpointer data);
    typedef             MateAppProgressKey;
    MateAppProgressKey  mate_app_progress_timeout         (MateApp *app,
                                                             const gchar *description,
                                                             guint32 interval,
                                                             MateAppProgressFunc percentage_cb,
                                                             MateAppProgressCancelFunc cancel_cb,
                                                             gpointer data);
    MateAppProgressKey  mate_app_progress_manual          (MateApp *app,
                                                             const gchar *description,
                                                             MateAppProgressCancelFunc cancel_cb,
                                                             gpointer data);
    void                mate_app_set_progress              (MateAppProgressKey key,
                                                             gdouble percent);
    void                mate_app_progress_done             (MateAppProgressKey key);

## Description

## Details

### mate_app_message ()

    GtkWidget *         mate_app_message                   (MateApp *app,
                                                             const gchar *message);

### Warning

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

A simple message, in an OK dialog or the status bar. Requires confirmation from the user before it goes away.

`app` : | Pointer to MATE app object
`message` : | Text of message to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_flash ()

    void                mate_app_flash                     (MateApp *app,
                                                             const gchar *flash);

### Warning

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

Flash the message in the statusbar for a few moments; if no statusbar, do nothing (?). For trivial little status messages, e.g. "Auto saving..."

`app` : | Pointer to MATE app object
`flash` : | Text of message to be flashed

### mate_app_error ()

    GtkWidget *         mate_app_error                     (MateApp *app,
                                                             const gchar *error);

### Warning

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

An important fatal error; if it appears in the statusbar, it might `gdk_beep()` and require acknowledgement.

`app` : | Pointer to MATE app object
`error` : | Text of error message to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_warning ()

    GtkWidget *         mate_app_warning                   (MateApp *app,
                                                             const gchar *warning);

### Warning

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

A not-so-important error, but still marked better than a flash

`app` : | Pointer to MATE app object
`warning` : | Text of warning message to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_question ()

    GtkWidget *         mate_app_question                  (MateApp *app,
                                                             const gchar *question,
                                                             MateReplyCallback callback,
                                                             gpointer data);

### Warning

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

Ask a yes or no question, and call the callback when it's answered.

`app` : | Pointer to MATE app object
`question` : | Text of question to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_question_modal ()

    GtkWidget *         mate_app_question_modal            (MateApp *app,
                                                             const gchar *question,
                                                             MateReplyCallback callback,
                                                             gpointer data);

### Warning

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

Ask a yes or no question, and call the callback when it's answered.

`app` : | Pointer to MATE app object
`question` : | Text of question to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_ok_cancel ()

    GtkWidget *         mate_app_ok_cancel                 (MateApp *app,
                                                             const gchar *message,
                                                             MateReplyCallback callback,
                                                             gpointer data);

### Warning

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

`app` : | Pointer to MATE app object
`message` : | Text of message to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_ok_cancel_modal ()

    GtkWidget *         mate_app_ok_cancel_modal           (MateApp *app,
                                                             const gchar *message,
                                                             MateReplyCallback callback,
                                                             gpointer data);

### Warning

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

`app` : | Pointer to MATE app object
`message` : | Text of message to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_request_string ()

    GtkWidget *         mate_app_request_string            (MateApp *app,
                                                             const gchar *prompt,
                                                             MateStringCallback callback,
                                                             gpointer data);

### Warning

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

`app` : | Pointer to MATE app object
`prompt` : | Text of prompt to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### mate_app_request_password ()

    GtkWidget *         mate_app_request_password          (MateApp *app,
                                                             const gchar *prompt,
                                                             MateStringCallback callback,
                                                             gpointer data);

### Warning

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

`app` : | Pointer to MATE app object
`prompt` : | Text of prompt to be displayed
Returns : | Pointer to dialog widget, or `NULL` if error or message in status bar.

### MateAppProgressFunc ()

    gdouble             (*MateAppProgressFunc)             (gpointer data);

### Warning

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

`data` : |
Returns : |

### MateAppProgressCancelFunc ()

    void                (*MateAppProgressCancelFunc)       (gpointer data);

### Warning

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

`data` : |

### MateAppProgressKey

    typedef gpointer MateAppProgressKey;

### Warning

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

### mate_app_progress_timeout ()

    MateAppProgressKey  mate_app_progress_timeout         (MateApp *app,
                                                             const gchar *description,
                                                             guint32 interval,
                                                             MateAppProgressFunc percentage_cb,
                                                             MateAppProgressCancelFunc cancel_cb,
                                                             gpointer data);

### Warning

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

Returns : |

### mate_app_progress_manual ()

    MateAppProgressKey  mate_app_progress_manual          (MateApp *app,
                                                             const gchar *description,
                                                             MateAppProgressCancelFunc cancel_cb,
                                                             gpointer data);

### Warning

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

Returns : |

### mate_app_set_progress ()

    void                mate_app_set_progress              (MateAppProgressKey key,
                                                             gdouble percent);

### Warning

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

### mate_app_progress_done ()

    void                mate_app_progress_done             (MateAppProgressKey key);

### Warning

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