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