Dialogs

Dialogs — user interaction helper functions.

Synopsis


#include <libxfcegui4/libxfcegui4.h>


void        xfce_err                        (const gchar *format,
                                             ...);
void        xfce_verr                       (const gchar *format,
                                             va_list ap);
void        xfce_warn                       (const gchar *format,
                                             ...);
void        xfce_vwarn                      (const gchar *format,
                                             va_list ap);
void        xfce_info                       (const gchar *format,
                                             ...);
void        xfce_vinfo                      (const gchar *format,
                                             va_list ap);
gboolean    xfce_confirm                    (const gchar *text,
                                             const gchar *stock_id,
                                             const gchar *action);
GtkWidget*  xfce_create_header              (GdkPixbuf *icon,
                                             const gchar *text);
GtkWidget*  xfce_create_header_with_image   (GtkWidget *image,
                                             const gchar *text);
GtkWidget*  xfce_create_mixed_button        (const gchar *stock,
                                             const gchar *text);
GtkWidget*  xfce_create_small_label         (const gchar *text);

Description

Provides simple user interaction functions, like error, warning and confirm dialogs.

Details

xfce_err ()

void        xfce_err                        (const gchar *format,
                                             ...);

Displays a modal error dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`...` :	argument list.

xfce_verr ()

void        xfce_verr                       (const gchar *format,
                                             va_list ap);

Displays a modal error dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`ap` :	variable argument list pointer.

xfce_warn ()

void        xfce_warn                       (const gchar *format,
                                             ...);

Displays a modal warning dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`...` :	argument list.

xfce_vwarn ()

void        xfce_vwarn                      (const gchar *format,
                                             va_list ap);

Displays a modal warning dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`ap` :	variable argument list pointer.

xfce_info ()

void        xfce_info                       (const gchar *format,
                                             ...);

Displays a modal info dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`...` :	argument list.

xfce_vinfo ()

void        xfce_vinfo                      (const gchar *format,
                                             va_list ap);

Displays a modal info dialog to the user and blocks until the users clicks the close button.

`format` :	printf-style format string.
`ap` :	variable argument list pointer.

xfce_confirm ()

gboolean    xfce_confirm                    (const gchar *text,
                                             const gchar *stock_id,
                                             const gchar *action);

Runs a modal confirmation dialog, that has a 'cancel' and a 'confirm' button. The 'confirm' button text can be set by action if given.

`text` :	a question text
`stock_id` :	a stock item name
`action` :	if non-NULL, this text is used on the confirm button together with the `stock` icon.
Returns :	TRUE if the user confirms, else FALSE.

xfce_create_header ()

GtkWidget*  xfce_create_header              (GdkPixbuf *icon,
                                             const gchar *text);

Creates a header with an optional icon (may be NULL) in larger bold font. Background and foreground colors are taken from Gtk+ style.

`icon` :	a GdkPixbuf or NULL if no icon should be displayed in the header.
`text` :	a text to be displayed in the header.
Returns :	the container widget that contains the header widgets.

xfce_create_header_with_image ()

GtkWidget*  xfce_create_header_with_image   (GtkWidget *image,
                                             const gchar *text);

Creates a header with an optional image (may be NULL) in larger bold font. Background and foreground colors are taken from Gtk+ style.

`image` :	a GtkImage or NULL if no image should be displayed in the header.
`text` :	the text to be displayed in the header.
Returns :	the container widget that contains the header widgets.

xfce_create_mixed_button ()

GtkWidget*  xfce_create_mixed_button        (const gchar *stock,
                                             const gchar *text);

Creates a button with both stock icon and text.

`stock` :	a stock item name.
`text` :	a text to display.
Returns :	the newly created mixed button widget.

xfce_create_small_label ()

GtkWidget*  xfce_create_small_label         (const gchar *text);

Creates a small italic label using Gtk's markup functionality.

`text` :	label text.
Returns :	the newly created label.