Top | ![]() |
![]() |
![]() |
![]() |
GtkWidget * | xfce_message_dialog_new () |
GtkWidget * | xfce_message_dialog_new_valist () |
gint | xfce_message_dialog () |
void | xfce_dialog_show_help () |
void | xfce_dialog_show_info () |
void | xfce_dialog_show_warning () |
void | xfce_dialog_show_error () |
gboolean | xfce_dialog_confirm () |
GtkWidget * xfce_message_dialog_new (GtkWindow *parent
,const gchar *title
,const gchar *stock_id
,const gchar *primary_text
,const gchar *secondary_text
,const gchar *first_button_text
,...
);
xfce_message_dialog_new() allows you to easily create Gtk+ message dialogs. It accepts GTK+ stock buttons, mixed buttons (using XFCE_BUTTON_TYPE_MIXED) or buttons with a GdkPixbuf (using XFCE_BUTTON_TYPE_PIXBUF).
The buttons are defined by first_button_text
and the next arguments in the
following format type
, param1
[, param2
, param3
].
|
This allows you to easily create mixed buttons in a dialog.
|
|
Creates a button with the GdkPixbuf as button icon.
|
Stock Buttons |
When the variables above were not matched, the button type
will be a stock button. |
To clarify this behaviour see the example below. We create a dialog with two stock buttons, a GdkPixbuf button and a mixed button.
Example 2. Creating a Xfce Message Dialog
1 2 3 4 5 6 7 8 9 10 11 12 13 |
GdkPixbuf *pixbuf = gdk_pixbuf_new_from_file_at_size (filename, 24, 24); GtkWidget *dialog = xfce_message_dialog (parent, "Question", GTK_STOCK_DIALOG_QUESTION, "There are unsaved modifications", "The menu has been modified, do you want to save it before quitting?", GTK_STOCK_SAVE, GTK_RESPONSE_YES, XFCE_BUTTON_TYPE_MIXED, GTK_STOCK_DELETE, "Forget modifications", GTK_RESPONSE_APPLY, XFCE_BUTTON_TYPE_PIXBUF, pixbuf, "Quit", GTK_RESPONSE_NO, GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL, NULL); g_object_unref (G_OBJECT (pixbuf)); |
parent |
transient parent of the dialog, or |
|
title |
title of the dialog, or |
|
stock_id |
gtk stock icon name to show in the dialog. |
|
primary_text |
primary text shown in large bold font. |
|
secondary_text |
secondary text shown in normal font. |
|
first_button_text |
text for the first button. |
|
... |
|
GtkWidget * xfce_message_dialog_new_valist (GtkWindow *parent
,const gchar *title
,const gchar *icon_stock_id
,const gchar *primary_text
,const gchar *secondary_text
,const gchar *first_button_text
,va_list args
);
See xfce_message_dialog_new()
, this version takes a va_list for
language bindings to use.
parent |
transient parent of the dialog, or |
|
title |
title of the dialog, or |
|
icon_stock_id |
gtk stock icon name to show in the dialog. |
|
primary_text |
primary text shown in large bold font. |
|
secondary_text |
secondary text shown in normal font. |
|
first_button_text |
text for the first button. |
|
args |
argument list. |
gint xfce_message_dialog (GtkWindow *parent
,const gchar *title
,const gchar *stock_id
,const gchar *primary_text
,const gchar *secondary_text
,const gchar *first_button_text
,...
);
Create a new dialog as in xfce_message_dialog_new()
, then runs the
dialog using gtk_dialog_run and return the response id selected by the user.
See xfce_message_dialog_new()
for more information.
parent |
transient parent of the dialog, or |
|
title |
title of the dialog, or |
|
stock_id |
gtk stock icon name to show in the dialog. |
|
primary_text |
primary text shown in large bold font. |
|
secondary_text |
secondary text shown in normal font. |
|
first_button_text |
text for the first button. |
|
... |
|
void xfce_dialog_show_help (GtkWindow *parent
,const gchar *application
,const gchar *page
,const gchar *offset
);
Asks the user to visit the online documentation. If confirmed, it will open the webbrowser and redirect the user to the correct location.
Appart from the component
, page
and offset
the following information
is also send to the server: user language and the xfce_version_string()
.
Since 4.10
void xfce_dialog_show_info (GtkWindow *parent
,const gchar *secondary_text
,const gchar *primary_format
,...
);
Displays an information dialog on parent
using the primary_format
as message.
void xfce_dialog_show_warning (GtkWindow *parent
,const gchar *secondary_text
,const gchar *primary_format
,...
);
Displays a warning dialog on parent
using the primary_format
as message.
void xfce_dialog_show_error (GtkWindow *parent
,const GError *error
,const gchar *primary_format
,...
);
Displays an error dialog on parent
using the primary_format
as primary message and optionally
displaying error
as secondary error text.
gboolean xfce_dialog_confirm (GtkWindow *parent
,const gchar *stock_id
,const gchar *confirm_label
,const gchar *secondary_text
,const gchar *primary_format
,...
);
Runs a questions dialog, that has a 'Cancel' and a 'Confirm' button. The 'Confirm'
button text can be set by action
if given.
If stock_id
is equal to GTK_STOCK_YES, the 'Cancel' button becomes a 'No' button.
parent |
transient parent of the dialog, or |
|
stock_id |
the stock name of the confirm button, for example GTK_STOCK_YES or GTK_STOCK_CLEAR. |
|
confirm_label |
if non- |
|
secondary_text |
secondary text in the dialog. |
|
primary_format |
the |
|
... |
argument list for the |
#define XFCE_BUTTON_TYPE_MIXED "button-mixed"
Used to define a mixed button in xfce_message_dialog_new()
and
xfce_message_dialog_run()
.
#define XFCE_BUTTON_TYPE_PIXBUF "button-pixbuf"
Used to define a GdkPixuf button in xfce_message_dialog_new()
and
xfce_message_dialog_run()
.