类

GtkLevelBar

描述 [src]

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

GtkLevelBar 是一个可用作电平指示器的微件。

典型用例是显示密码强度或显示电池电量。

An example GtkLevelBar

使用 gtk_level_bar_set_value() 设置当前值，使用 gtk_level_bar_add_offset_value() 设置条形将被视为处于不同状态的值偏移量。 GTK 会在电平条形上默认添加一些偏移量：GTK_LEVEL_BAR_OFFSET_LOW、GTK_LEVEL_BAR_OFFSET_HIGH 和 GTK_LEVEL_BAR_OFFSET_FULL，值分别为 0.25、0.75 和 1.0。

请注意，更改最小值或最大值时，更新现有偏移量是你的责任。 GTK 只会将其限制在新范围。

在条形上添加自定义偏移量

static GtkWidget *
create_level_bar (void)
{
  GtkWidget *widget;
  GtkLevelBar *bar;

  widget = gtk_level_bar_new ();
  bar = GTK_LEVEL_BAR (widget);

  // This changes the value of the default low offset

  gtk_level_bar_add_offset_value (bar,
                                  GTK_LEVEL_BAR_OFFSET_LOW,
                                  0.10);

  // This adds a new offset to the bar; the application will
  // be able to change its color CSS like this:
  //
  // levelbar block.my-offset {
  //   background-color: magenta;
  //   border-style: solid;
  //   border-color: black;
  //   border-width: 1px;
  // }

  gtk_level_bar_add_offset_value (bar, "my-offset", 0.60);

  return widget;
}

值的默认间隔介于零到一之间，但可以使用 gtk_level_bar_set_min_value() 和 gtk_level_bar_set_max_value() 修改间隔。值将始终按可接受间隔成比例绘制，即在 10 和 20 之间指定间隔的值 15 等于在 0 和 1 之间间隔的值 0.5。当使用 GTK_LEVEL_BAR_MODE_DISCRETE 时，条形电平将作为有限数量的分离块呈现，而不是单个块。要呈现的块数等于可接受间隔指定的单位数。

例如，要构建一个用五个块呈现的条形，只需将最小值设为 0，将最大值设为 5，然后将指示器模式更改为离散即可。

GtkLevelBar 作为 GtkBuildable

GtkLevelBar 对 GtkBuildable 接口的实现支持自定义 <offsets> 元素，其中可以包含任意数量的 <offset> 元素，每个元素都必须具有 “name” 和 “value” 属性。

CSS 节点

levelbar[.discrete]
╰── trough
    ├── block.filled.level-name
    ┊
    ├── block.empty
    ┊

GtkLevelBar 具有一个名为 levelbar 的主 CSS 节点和一个样式类 .discrete 或 .continuous 以及一个名为 trough 的子节点。trough 节点下面是若干个名为 block 且样式类为 .filled 或 .empty 的节点。在连续模式下，每个节点都只有一个，在离散模式下，已填和未填节点的数量对应绘制的块。block.filled 节点还会获得一个样式类 .level-name 对应当前值的级别。

在水平方向中，不管文本方向，节点始终从左到右排列。