Interface: Totem Reference Manual

Go to page content
Go to main menu
Go to the search field

Interface

Interface — interface utility/loading/error functions

Stability Level

Unstable, unless otherwise indicated

Functions

void	totem_interface_error ()
void	totem_interface_error_blocking ()
void	totem_interface_error_with_link ()

Includes

#include <totem-interface.h>

Description

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

Functions

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.

Parameters

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.

Parameters

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.

Parameters

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

Types and Values