Gtk.InfoBar – gtk4 Reference Manual

InfoBar

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_info_bar_get_type ()" ) ]
public class InfoBar : Widget, Accessible, Buildable, ConstraintTarget

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

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

It is often temporarily shown at the top or bottom of a document. In contrast to [[email protected]], 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 [ [email protected]_button] or [[email protected]_with_buttons]. The sensitivity of action widgets can be controlled with [ [email protected]_response_sensitive].

To add widgets to the main content area of a `GtkInfoBar`, use [[email protected]_child].

Similar to [[email protected]], the contents of a `GtkInfoBar` can by classified as error message, warning, informational message, etc, by using [[email protected]_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

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable

2022 vala-language.org