GtkStatusbar

不赞成:4.10 

说明 [src]

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

GtkStatusbar 小组建通常放置在应用程序主 GtkWindow 的底部。

An example GtkStatusbar

GtkStatusBar 可以提供应用程序状态的定期注释(例如,web 浏览器中的情况),也可以在状态改变时仅用于输出消息(例如,FTP 客户端中上传完成)。

GTK 中的状态栏维护一个消息堆栈。每个栏堆栈顶部的消息是最当前显示的消息。

添加到状态栏堆栈的任何消息都必须指定一个上下文 ID,用以唯一标识消息的来源。可以使用 gtk_statusbar_get_context_id() 根据消息及其将添加到其中的状态栏来生成此上下文 ID。请注意,消息存储在堆栈中,在选择要显示的消息时,会坚持堆栈结构,无论消息的上下文标识符为何。

可以这样说,状态栏维护一个供显示目的的消息堆栈,但允许多个消息生成器维护它们生成的消息的子堆栈(通过上下文 ID)。

使用 gtk_statusbar_new() 来创建状态栏。

使用 gtk_statusbar_push() 将消息添加到栏的堆栈。

可以使用 gtk_statusbar_pop() 删除堆栈顶部的消息。如果消息 ID 在添加消息时被记录下来,可以从堆栈中的任意位置删除消息。这是使用 gtk_statusbar_remove() 来完成的。

CSS 节点

GtkStatusbar 有一个名为 statusbarCSS 节点。

已弃用,自:4.10

此组件将在 GTK 5 中删除。

层次结构

hierarchy this GtkStatusbar implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_statusbar_new

创建一个新的 GtkStatusbar,为消息做好准备。

不赞成:4.10 

实例方法

gtk_statusbar_get_context_id

返回一个新上下文标识符,给定实际上下文的描述。

不赞成:4.10 

gtk_statusbar_pop

使用给定的 context id 移除 `GtkStatusbar` 堆栈中的第一条消息。

不赞成:4.10 

gtk_statusbar_push

将新消息推送到状态栏的堆栈中。

不赞成:4.10 

gtk_statusbar_remove

强制从状态栏的堆栈中移除一条消息。必须指定确切的 `context_id` 和 `message_id`。

不赞成:4.10 

gtk_statusbar_remove_all

强制从状态栏的堆栈中移除所有消息,确切 `context_id`。

不赞成:4.10 

从 `GtkWidget`(162)继承的方法

请参阅 `GtkWidget`的完整方法列表。

从 `GObject`(43)继承的方法

请参阅 `GObject`的完整方法列表。

从 `GtkAccessible`(19)继承的方法
gtk_accessible_announce

请求用户的屏幕阅读器播报给定消息。

since: 4.14

gtk_accessible_get_accessible_parent

为可访问对象检索可访问父级。

since: 4.10

gtk_accessible_get_accessible_role

检索可访问对象的辅助角色。

gtk_accessible_get_at_context

检索给定可访问对象的实现。

since: 4.10

gtk_accessible_get_bounds

查询此可访问对象的坐标和尺寸。

since: 4.10

gtk_accessible_get_first_accessible_child

检索可访问对象的第一个可访问子级。

since: 4.10

gtk_accessible_get_next_accessible_sibling

检索可访问对象的下一个可访问同级对象。

since: 4.10

gtk_accessible_get_platform_state

查询平台状态,例如焦点。

since: 4.10

gtk_accessible_reset_property

将可访问属性重置为其默认值。

gtk_accessible_reset_relation

将可访问关系重置为其默认值。

gtk_accessible_reset_state

将可访问状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置可访问对象的父级和同级对象。

since: 4.10

gtk_accessible_update_next_accessible_sibling

更新下一个可访问同级对象。

since: 4.10

gtk_accessible_update_property

更新可访问属性列表。

gtk_accessible_update_property_value

更新数组访问属性。

gtk_accessible_update_relation

更新可访问关系列表。

gtk_accessible_update_relation_value

更新一系列可访问关系。

gtk_accessible_update_state

更新可访问状态列表。

gtk_accessible_update_state_value

更新数组访问状态。

从 `GtkBuildable`(1)继承的方法
gtk_buildable_get_buildable_id

获取 `buildable` 对象的 `ID`。

属性

从 `GtkWidget`(34)继承的属性
Gtk.Widget:can-focus

小部件或其任何后代是否可以接受输入焦点。

Gtk.Widget:can-target

小部件是否可以接收指针事件。

Gtk.Widget:css-classes

应用于此小部件的 css 类列表。

Gtk.Widget:css-name

在 `CSS` 树中此小部件的名称。

Gtk.Widget:cursor

`widget` 使用的游标。

Gtk.Widget:focus-on-click

使用鼠标单击时小部件是否应获取焦点。

Gtk.Widget:focusable

此小部件本身是否将接受输入焦点。

Gtk.Widget:halign

如果小部件获得额外空间,如何分配水平空间。

Gtk.Widget:has-default

小部件是否是默认小部件。

Gtk.Widget:has-focus

小部件是否具有输入焦点。

Gtk.Widget:has-tooltip

启用或禁用 `widget` 上 `GtkWidget::query-tooltip` 信号的发射。

Gtk.Widget:height-request

替代小部件的高度请求。

Gtk.Widget:hexpand

是否水平展开。

Gtk.Widget:hexpand-set

是否使用 `hexpand` 属性。

Gtk.Widget:layout-manager

用于计算小组件的首选大小和分配其子组件的 GtkLayoutManager 实例。

Gtk.Widget:margin-bottom

小组件底部边缘的边距。

Gtk.Widget:margin-end

小组件尾部的边距(水平方向)。

Gtk.Widget:margin-start

小组件开头的边距(水平方向)。

Gtk.Widget:margin-top

小组件顶部边缘的边距。

Gtk.Widget:name

小组件的名称。

Gtk.Widget:opacity

小组件的请求不透明度。

Gtk.Widget:overflow

处理小组件内容区域外部内容的方式。

Gtk.Widget:parent

此小组件的父小组件。

Gtk.Widget:receives-default

小组件获得焦点时,小组件接收默认操作。

Gtk.Widget:root

包含此小组件的小组件树的 GtkRoot 小组件。

Gtk.Widget:scale-factor

小组件的缩放比例。

Gtk.Widget:sensitive

小组件是否对输入作出响应。

Gtk.Widget:tooltip-markup

将工具提示的文本设置为给定字符串,该字符串用 Pango 标记标记。

Gtk.Widget:tooltip-text

将工具提示的文本设置为给定字符串。

Gtk.Widget:valign

如果小组件获得额外的空间,如何分配垂直空间。

Gtk.Widget:vexpand

是否垂直扩展。

Gtk.Widget:vexpand-set

是否使用 vexpand 属性。

Gtk.Widget:visible

小组件是否可见。

Gtk.Widget:width-request

替代小组件的宽度请求。

继承自 GtkAccessible 的属性 (1)
GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

信号

Gtk.Statusbar::text-popped

每当从状态栏的堆栈中弹出新消息时发出。

不赞成:4.10 

Gtk.Statusbar::text-pushed

每当将新消息推送到状态栏的堆栈中时发出。

不赞成:4.10 

继承自 GtkWidget 的信号 (13)
GtkWidget::destroy

信号是指,拥有对小组件的引用的所有持有人都应释放他们持有的引用。

GtkWidget::direction-changed

小组件的文本方向发生更改时发出。

GtkWidget::hide

widget 隐藏时发出。

GtkWidget::keynav-failed

如果键盘导航失败,则发出。

GtkWidget::map

widget 将要映射时发出。

GtkWidget::mnemonic-activate

通过助记词激活小组件时发出。

GtkWidget::move-focus

焦点移动时发出。

GtkWidget::query-tooltip

小组件的工具提示即将显示时发出。

GtkWidget::realize

widgetGdkSurface 关联时发出。

GtkWidget::show

widget 显示时发出。

GtkWidget::state-flags-changed

小组件状态发生更改时发出。

GtkWidget::unmap

widget 将要取消映射时发出。

GtkWidget::unrealize

widget 关联的 GdkSurface 被销毁时发出。

继承自 GObject 的信号 (1)
GObject::notify

当对象的某个属性通过 g_object_set_property()、g_object_set() 等设置值时,在对象上发出通知信号。