类型
GtkProgressBar
描述 [src]
final class Gtk.ProgressBar : Gtk.Widget
implements Gtk.Accessible, Gtk.AccessibleRange, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable {
/* No available fields */
}GtkProgressBar 通常用于显示正在进行的长时间运算的进度。
它提供一个直观的提示，表示处理正在进行中。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 角色。