![]() | ![]() | ![]() | libxfcegui4 Reference Manual | ![]() |
---|
Dialogs — user interaction helper functions.
#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);
Provides simple user interaction functions, like error, warning and confirm dialogs.
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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 GUI Core Reference | XfceAboutDialog >> |