Struct gtk4::InfoBar

source · [−]

#[repr(transparent)]
pub struct InfoBar { /* private fields */ }

Expand description

InfoBar can be show messages to the user without a dialog.

An example GtkInfoBar

It is often temporarily shown at the top or bottom of a document. In contrast to Dialog, which has an action area at the bottom, InfoBar has an action area at the side.

The API of InfoBar is very similar to Dialog, allowing you to add buttons to the action area with add_button() or with_buttons(). The sensitivity of action widgets can be controlled with set_response_sensitive().

To add widgets to the main content area of a InfoBar, use add_child().

Similar to MessageDialog, the contents of a InfoBar can by classified as error message, warning, informational message, etc, by using set_message_type(). GTK may use the message type to determine how the message is displayed.

A simple example for using a InfoBar: ⚠️ The following code is in 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

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

InfoBar 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

InfoBar 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.

Implements

WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, WidgetExtManual, AccessibleExtManual

Struct gtk4::InfoBar

Implementations

impl InfoBar

pub fn new() -> InfoBar

pub fn builder() -> InfoBarBuilder

pub fn add_action_widget( &self, child: &impl IsA<Widget>, response_id: ResponseType)

pub fn add_button(&self, button_text: &str, response_id: ResponseType) -> Button

pub fn add_child(&self, widget: &impl IsA<Widget>)

pub fn message_type(&self) -> MessageType

pub fn is_revealed(&self) -> bool

pub fn shows_close_button(&self) -> bool

pub fn remove_action_widget(&self, widget: &impl IsA<Widget>)

pub fn remove_child(&self, widget: &impl IsA<Widget>)

pub fn response(&self, response_id: ResponseType)

pub fn set_default_response(&self, response_id: ResponseType)

pub fn set_message_type(&self, message_type: MessageType)

pub fn set_response_sensitive(&self, response_id: ResponseType, setting: bool)

pub fn set_revealed(&self, revealed: bool)

pub fn set_show_close_button(&self, setting: bool)

pub fn connect_close<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

pub fn emit_close(&self)

pub fn connect_response<F: Fn(&Self, ResponseType) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_message_type_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_revealed_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_show_close_button_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

impl InfoBar

pub fn with_buttons(buttons: &[(&str, ResponseType)]) -> Self

pub fn add_buttons(&self, buttons: &[(&str, ResponseType)])

Trait Implementations

impl Clone for InfoBar

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for InfoBar

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Default for InfoBar

fn default() -> Self

impl Display for InfoBar

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Hash for InfoBar

fn hash<H>(&self, state: &mut H) where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher,

impl Ord for InfoBar

fn cmp(&self, other: &Self) -> Ordering

fn max(self, other: Self) -> Self

fn min(self, other: Self) -> Self

fn clamp(self, min: Self, max: Self) -> Self

impl ParentClassIs for InfoBar

type Parent = Widget

impl<OT: ObjectType> PartialEq<OT> for InfoBar

fn eq(&self, other: &OT) -> bool

fn ne(&self, other: &Rhs) -> bool

impl<OT: ObjectType> PartialOrd<OT> for InfoBar

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

fn lt(&self, other: &Rhs) -> bool

fn le(&self, other: &Rhs) -> bool

fn gt(&self, other: &Rhs) -> bool

fn ge(&self, other: &Rhs) -> bool

impl StaticType for InfoBar

fn static_type() -> Type

impl Eq for InfoBar

impl IsA<Accessible> for InfoBar

impl IsA<Buildable> for InfoBar

impl IsA<ConstraintTarget> for InfoBar

impl IsA<Widget> for InfoBar

Auto Trait Implementations

impl RefUnwindSafe for InfoBar

impl !Send for InfoBar

impl !Sync for InfoBar

impl Unpin for InfoBar

impl UnwindSafe for InfoBar

Blanket Implementations

impl<O> AccessibleExtManual for O where O: IsA<Accessible>,

fn update_property(&self, properties: &[Property<'_>])

fn update_relation(&self, relations: &[Relation<'_>])

fn update_state(&self, states: &[State])

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn add_action_widget(
&self,
child: &impl IsA<Widget>,
response_id: ResponseType
)

pub fn connect_response<F: Fn(&Self, ResponseType) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_message_type_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_revealed_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_show_close_button_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

fn hash<H>(&self, state: &mut H) where
H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,

impl<O> AccessibleExtManual for O where
O: IsA<Accessible>,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T> Cast for T where
T: ObjectType,

fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self> where
T: ObjectType,
Self: CanDowncast<T>,

fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,

fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,

impl<T, U> Into<U> for T where
U: From<T>,

impl<U> IsSubclassableExt for U where
U: IsClass + ParentClassIs,

fn parent_class_init<T>(class: &mut Class<U>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,

fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,

impl<T> ObjectExt for T where
T: ObjectType,

fn is<U>(&self) -> bool where
U: StaticType,

fn class(&self) -> &Class<T> where
T: IsClass,

fn class_of<U>(&self) -> Option<&Class<U>> where
U: IsClass,

fn interface<U>(&self) -> Option<InterfaceRef<'_, U>> where
U: IsInterface,

fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,

fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,

fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>

fn try_set_properties(
&self,
property_values: &[(&str, &dyn ToValue)]
) -> Result<(), BoolError>

fn try_set_properties_from_value(
&self,
property_values: &[(&str, Value)]
) -> Result<(), BoolError>

fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,

fn property<V>(&self, property_name: &str) -> V where
V: 'static + for<'b> FromValue<'b>,