## Interface Interface — interface utility/loading/error functions |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <totem-interface.h>

    void                totem_interface_error               (const char *title,
                                                             const char *reason,
                                                             GtkWindow *parent);
    void                totem_interface_error_blocking      (const char *title,
                                                             const char *reason,
                                                             GtkWindow *parent);
    void                totem_interface_error_with_link     (const char *title,
                                                             const char *reason,
                                                             const char *uri,
                                                             const char *label,
                                                             GtkWindow *parent);

## Description

A collection of interface utility functions, for loading interfaces and displaying errors.

## Details

### totem_interface_error ()

    void                totem_interface_error               (const char *title,
                                                             const char *reason,
                                                             GtkWindow *parent);

Display a modal error dialogue with `title` as its primary error text, and `reason` as its secondary text.

`title` : | the error title
`reason` : | the error reason (secondary text)
`parent` : | the error dialogue's parent GtkWindow

### totem_interface_error_blocking ()

    void                totem_interface_error_blocking      (const char *title,
                                                             const char *reason,
                                                             GtkWindow *parent);

Display a modal error dialogue like `totem_interface_error()` which blocks until the user has dismissed it.

`title` : | the error title
`reason` : | the error reason (secondary text)
`parent` : | the error dialogue's parent GtkWindow

### totem_interface_error_with_link ()

    void                totem_interface_error_with_link     (const char *title,
                                                             const char *reason,
                                                             const char *uri,
                                                             const char *label,
                                                             GtkWindow *parent);

Display a modal error dialogue like `totem_interface_error()`, but add a button which will open `uri` in a browser window.

`title` : | the error title
`reason` : | the error reason (secondary text)
`uri` : | the URI to open
`label` : | a label for the URI's button, or `NULL` to use `uri` as the label
`parent` : | the error dialogue's parent GtkWindow