类型

GtkProgressBar

描述 [src]

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

GtkProgressBar 通常用于显示正在进行的长时间运算的进度。

它提供一个直观的提示，表示处理正在进行中。GtkProgressBar 可用于两种不同的模式：百分比模式和活动模式。

An example GtkProgressBar

当一个应用程序能确定需要执行多少工作（例如从一个文件中读取固定数量的字节）并且能监控其进度时，它可在百分比模式中使用 GtkProgressBar，并且用户会看到一个不断增长的条形图，显示已完成工作的百分比。在此模式中，应用程序需要定期调用 gtk_progress_bar_set_fraction() 来更新进度条。

当一个应用程序没有准确的方式来知道要完成的工作量时，它可在活动模式中使用 GtkProgressBar，此模式通过在一个块在进度区域内来回移动来显示活动。在此模式中，应用程序需要定期调用 gtk_progress_bar_pulse() 来更新进度条。

提供了一些灵活性来控制 GtkProgressBar 的外观。提供了用于控制条形图方向的函数，可以在条形图旁边显示文本，且可以在活动模式中设置步长。

CSS 节点

progressbar[.osd]
├── [text]
╰── trough[.empty][.full]
    ╰── progress[.pulse]

GtkProgressBar 具有一个带名称 progressbar 的 CSS 主节点，以及带名称 text 和 trough 的子节点，其中后者有一个名为 progress 的子节点。只有当显示文本时才有文本子节点。在活动模式下，progress 子节点具有样式类 .pulse。当进度“接触” GtkProgressBar 的相应末端时，会添加样式类 .left、.right、.top 或 .bottom。progressbar 节点上的 .osd 类用于使用 Epiphany 用于页面加载进度的覆盖，例如覆盖。

辅助功能

GtkProgressBar 使用 GTK_ACCESSIBLE_ROLE_PROGRESS_BAR 角色。

层级

祖先

实现

构造方法

gtk_progress_bar_new

创建一个新的 GtkProgressBar。

从 GtkWidget （162）继承的方法

有关完整的方法列表，请参阅 GtkWidget。

从 GObject （43）继承的方法

有关完整的方法列表，请参阅 GObject。

从 GtkBuildable （1）继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkOrientable （2）继承的方法

gtk_orientable_get_orientation

检索 orientable 的方向。

gtk_orientable_set_orientation

设置 orientable 的方向。

从 GtkAccessible (1) 继承的属性

GtkAccessible:accessible-role

给定 GtkAccessible 实现的辅助角色。

从 GtkOrientable (1) 继承的属性

GtkOrientable:orientation

的可定向的控件的方向。

信号

从 GObject (1) 继承来的信号

GObject::notify

当某个属性的值通过 g_object_set_property()、g_object_set() 等设置时，该属性所在的对象上会触发 notify 信号。