gtkInfoBarNew(show = TRUE)
gtkInfoBarNewWithButtons(first.button.text, ...)
gtkInfoBarAddActionWidget(object, child, response.id)
gtkInfoBarAddButton(object, button.text, response.id)
gtkInfoBarAddButtons(object, first.button.text, ...)
gtkInfoBarSetResponseSensitive(object, response.id, setting)
gtkInfoBarSetDefaultResponse(object, response.id)
gtkInfoBarResponse(object, response.id)
gtkInfoBarSetMessageType(object, message.type)
gtkInfoBarGetMessageType(object)
gtkInfoBarGetActionArea(object)
gtkInfoBarGetContentArea(object)
gtkInfoBar(first.button.text, ..., show = TRUE)
GtkBuildable
and GtkOrientable
.GtkInfoBar
is a widget that can be used to show messages to
the user without showing a dialog. It is often temporarily shown
at the top or bottom of a document. In contrast to GtkDialog
, which
has a horizontal action area at the bottom, GtkInfoBar
has a
vertical action area at the side.
The API of GtkInfoBar
is very similar to GtkDialog
, allowing you
to add buttons to the action area with gtkInfoBarAddButton
or
gtkInfoBarNewWithButtons
. The sensitivity of action widgets
can be controlled with gtkInfoBarSetResponseSensitive
.
To add widgets to the main content area of a GtkInfoBar
, use
gtkInfoBarGetContentArea
and add your widgets to the container.
Similar to GtkMessageDialog
, the contents of a GtkInfoBar
can by
classified as error message, warning, informational message, etc,
by using gtkInfoBarSetMessageType
. GTK+ uses the message type
to determine the background color of the message area.
Simple GtkInfoBar usage./* set up info bar */
info_bar = gtk_info_bar_new ();
gtk_widget_set_no_show_all (info_bar, TRUE);
message_label = gtk_label_new ("");
gtk_widget_show (message_label);
content_area = gtk_info_bar_get_content_area (GTK_INFO_BAR (info_bar));
gtk_container_add (GTK_CONTAINER (content_area), message_label);
gtk_info_bar_add_button (GTK_INFO_BAR (info_bar),
GTK_STOCK_OK, GTK_RESPONSE_OK);
g_signal_connect (info_bar, "response",
G_CALLBACK (gtk_widget_hide), NULL);
gtk_table_attach (GTK_TABLE (table),
info_bar,
0, 1, 2, 3,
GTK_EXPAND | GTK_FILL, 0,
0, 0);/* ... */
/* show an error message */ gtk_label_set_text (GTK_LABEL (message_label), error_message); gtk_info_bar_set_message_type (GTK_INFO_BAR (info_bar), GTK_MESSAGE_ERROR); gtk_widget_show (info_bar);
action.area
).gtkInfoBar
is the result of collapsing the constructors of GtkInfoBar
(gtkInfoBarNew
, gtkInfoBarNewWithButtons
) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.