类

GtkInfoBar

已弃用：4.10

描述 [src]

final class Gtk.InfoBar : Gtk.Widget
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget {
  /* No available fields */
}

GtkInfoBar 可用于向用户显示消息而不使用对话框。

An example GtkInfoBar

它通常临时显示在文档的顶部或底部。与带底部操作区域的 GtkDialog 不同，GtkInfoBar 具有侧边的操作区域。

GtkInfoBar 的 API 与 GtkDialog 非常相似，您可以使用 gtk_info_bar_add_button() 或 gtk_info_bar_new_with_buttons() 将按钮添加到操作区域。可以使用 gtk_info_bar_set_response_sensitive() 控制操作组件的灵敏度。

要将组件添加到 GtkInfoBar 的主要内容区域，请使用 gtk_info_bar_add_child()。

与 GtkMessageDialog 相似，可以通过使用 gtk_info_bar_set_message_type() 将 GtkInfoBar 的内容分类为错误消息、警告、信息性消息等。GTK 可能会使用消息类型来决定如何显示消息。

使用 GtkInfoBar 的简单示例

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 作为 GtkBuildable

GtkInfoBar 支持自定义的 <action-widgets> 元素，其中可以包含多个 <action-widget> 元素。"response" 属性指定一个数字响应，元素的内容是组件的 ID（应位于对话框的 action_area 内的子节点）。

GtkInfoBar 支持通过指定 <child> 元素的 “type” 属性为 “action” 来添加操作小部件。小部件将被添加到操作区域。响应 ID 必须通过 <action-widgets> 元素与操作小部件关联。

CSS 节点

GtkInfoBar 有一个名为 infobar 的单个 CSS 节点。节点可以采用 .info、.warning、.error 或 .question 中的一个样式类，具体取决于消息类型。如果信息栏显示关闭按钮，则该按钮将应用 .close 样式类。

自 4.10 版本以来已弃用

GTK 中没有 “信息栏” 小部件的替代方案；根据您应用程序的设计，您可以使用包含 GtkLabel 和可选的 GtkButton 的 GtkBox 结合 GtkRevealer。

层次结构

祖先

实现

构造函数

gtk_info_bar_new

创建一个新的 GtkInfoBar 对象。

已弃用：4.10

gtk_info_bar_new_with_buttons

创建一个新的带有按钮的 GtkInfoBar。

已弃用：4.10

从 GtkWidget 继承的方法（162）

请参阅 GtkWidget 以获取方法的全列表。

从 GObject 继承的方法（43）

请参阅 GObject 以获取方法的全列表。

从GtkBuildable继承的方法（1）

gtk_buildable_get_buildable_id

获取buildable对象的ID。

从 GtkAccessible 继承的属性（1）

GtkAccessible:accessible-role

指定 GtkAccessible 实现的辅助功能角色。

信号

Gtk.InfoBar::close

当用户使用快捷键关闭信息栏时发出。

Gtk.InfoBar::response

当点击操作小部件时发出。

从 GObject 继承的信号（1）

GObject::notify

当对象的一个属性通过 g_object_set_property()、g_object_set() 等 set 时发出通知信号。

描述 [src]

GtkInfoBar 作为 GtkBuildable

CSS 节点

层次结构

祖先

实现

构造函数

实例方法

从 GtkWidget 继承的方法（162）

从 GObject 继承的方法（43）

从 GtkAccessible 继承的方法（19）

从GtkBuildable继承的方法（1）

属性

从GtkWidget继承的属性（34）

从 GtkAccessible 继承的属性（1）

信号

从 GtkWidget 继承的信号（13）

从 GObject 继承的信号（1）