InfoBar

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_info_bar_get_type ()" ) ]
[ Version ( deprecated = true , deprecated_since = "4.10" ) ]
public sealed class InfoBar : Widget, Accessible, Buildable, ConstraintTarget

Warning: InfoBar is deprecated since 4.10.

`GtkInfoBar` can be used to show messages to the user without a dialog.

Note:

There is no replacement in GTK for an "info bar" widget; you can use [class@Gtk.Revealer] with a [class@Gtk.Box] containing a [ class@Gtk.Label] and an optional [class@Gtk.Button], according to your application's design.

![An example GtkInfoBar](info-bar.png)

It is often temporarily shown at the top or bottom of a document. In contrast to [class@Gtk.Dialog], which has an action area at the bottom, `GtkInfoBar` has an action area at the side.

The API of `GtkInfoBar` is very similar to `GtkDialog`, allowing you to add buttons to the action area with [method@Gtk.InfoBar.add_button] or [ctor@Gtk.InfoBar.new_with_buttons]. The sensitivity of action widgets can be controlled with [method@Gtk.InfoBar.set_response_sensitive].

To add widgets to the main content area of a `GtkInfoBar`, use [method@Gtk.InfoBar.add_child].

Similar to [class@Gtk.MessageDialog], the contents of a `GtkInfoBar` can by classified as error message, warning, informational message, etc, by using [method@Gtk.InfoBar.set_message_type]. GTK may use the message type to determine how the message is displayed.

A simple example for using a `GtkInfoBar`: ```c GtkWidget *message_label; GtkWidget *widget; GtkWidget *grid; GtkInfoBar *bar;

// set up info bar widget = gtk_info_bar_new (); bar = GTK_INFO_BAR (widget); grid = gtk_grid_new ();

message_label = gtk_label_new (""); gtk_info_bar_add_child (bar, message_label); gtk_info_bar_add_button (bar, _("_OK"), GTK_RESPONSE_OK); g_signal_connect (bar, "response", G_CALLBACK (gtk_widget_hide), NULL); gtk_grid_attach (GTK_GRID (grid), widget, 0, 2, 1, 1);

// ...

// show an error message gtk_label_set_text (GTK_LABEL (message_label), "An error occurred!"); gtk_info_bar_set_message_type (bar, GTK_MESSAGE_ERROR); gtk_widget_show (bar); ```

GtkInfoBar as GtkBuildable

`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).

`GtkInfoBar` supports adding action widgets by specifying “action” as the “type” attribute of a `<child>` element. The widget will be added either to the action area. The response id has to be associated with the action widget using the `<action-widgets>` element.

CSS nodes

`GtkInfoBar` has a single CSS node with name infobar. The node may get one of the style classes .info, .warning, .error or .question, depending on the message type. If the info bar shows a close button, that button will have the .close style class applied.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public MessageType message_type { get; set construct; }
The type of the message.
public bool revealed { get; set; }
Whether the info bar shows its contents.
public bool show_close_button { get; set construct; }
Whether to include a standard close button.

Creation methods:

public InfoBar ()
Creates a new `GtkInfoBar` object.
public InfoBar.with_buttons (...)
Creates a new `GtkInfoBar` with buttons.

Methods:

public void add_action_widget (Widget child, int response_id)
Add an activatable widget to the action area of a `GtkInfoBar`.
public unowned Button add_button (string button_text, int response_id)
Adds a button with the given text.
public void add_buttons (...)
Adds multiple buttons.
public void add_child (Widget widget)
Adds a widget to the content area of the info bar.
public MessageType get_message_type ()
Returns the message type of the message area.
public bool get_revealed ()
Returns whether the info bar is currently revealed.
public bool get_show_close_button ()
Returns whether the widget will display a standard close button.
public void remove_action_widget (Widget widget)
Removes a widget from the action area of this .
public void remove_child (Widget widget)
Removes a widget from the content area of the info bar.
public void set_default_response (int response_id)
Sets the last widget in the info bar’s action area with the given response_id as the default widget for the dialog.
public void set_message_type (MessageType message_type)
Sets the message type of the message area.
public void set_response_sensitive (int response_id, bool setting)
Sets the sensitivity of action widgets for response_id.
public void set_revealed (bool revealed)
Sets whether the `GtkInfoBar` is revealed.
public void set_show_close_button (bool setting)
If true, a standard close button is shown.

Signals:

public signal void close ()
Gets emitted when the user uses a keybinding to dismiss the info bar.
public signal void response (int response_id)
Emitted when an action widget is clicked.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable