GtkInfoBar

Description

Report important messages to the user

Methods and Functions

gtkInfoBarNew(show = TRUE)
gtkInfoBarNewWithButtons(first.button.text, ..., show = TRUE)
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)

Hierarchy

1
2
3
4
5
6
7
8
GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkHBox
                                       +----GtkInfoBar

Interfaces

GtkInfoBar implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Detailed Description

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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/* 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);

GtkInfoBar as GtkBuildable The GtkInfoBar implementation of the GtkBuildable interface exposes the content area and action area as internal children with the names "content_area" and "action_area".

GtkInfoBar supports a custom <action-widgets> element, which can contain multiple <action-widget> elements. The "response" attribute specifies a numeric response, and the content of the element is the id of widget (which should be a child of the dialogs action.area).

Structures

GtkInfoBar

undocumented

Convenient Construction

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.

Signals

close(user.data)

The ::close signal is a keybinding signal which gets emitted when the user uses a keybinding to dismiss the info bar.

The default binding for this signal is the Escape key. Since 2.18

user.data

user data set when the signal handler was connected.

response(info.bar, response.id, user.data)

Emitted when an action widget is clicked or the application programmer calls gtkDialogResponse. The response.id depends on which action widget was clicked. Since 2.18

info.bar

the object on which the signal is emitted

response.id

the response ID

user.data

user data set when the signal handler was connected.

Properties

message-type [GtkMessageType : Read / Write / Construct]

The type of the message.

The type is used to determine the colors to use in the info bar. The following symbolic color names can by used to customize these colors: "info_fg_color", "info_bg_color", "warning_fg_color", "warning_bg_color", "question_fg_color", "question_bg_color", "error_fg_color", "error_bg_color". "other_fg_color", "other_bg_color".

If the type is GTK_MESSAGE_OTHER, no info bar is painted but the colors are still set. Default value: GTK_MESSAGE_INFO Since 2.18

Style Properties

action-area-border [integer : Read]

Width of the border around the action area of the info bar. Allowed values: >= 0 Default value: 5 Since 2.18

button-spacing [integer : Read]

Spacing between buttons in the action area of the info bar. Allowed values: >= 0 Default value: 6 Since 2.18

content-area-border [integer : Read]

The width of the border around the content content area of the info bar. Allowed values: >= 0 Default value: 8 Since 2.18

content-area-spacing [integer : Read]

The default spacing used between elements of the content area of the info bar. Allowed values: >= 0 Default value: 16 Since 2.18

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://library.gnome.org/devel//gtk/GtkInfoBar.html

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.