类

GtkScale

简介 [src]

class Gtk.Scale : Gtk.Range
  implements Gtk.Accessible, Gtk.AccessibleRange, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable {
  /* No available fields */
}

GtkScale 是一个用于选择数值的滑动控件。

An example GtkScale

若要使用它，您可能需要研究其基类 GtkRange 中的方法，以及 GtkScale 本身的方法。要设置滚动条的值，通常会使用 gtk_range_set_value()。要检测该值的更改，通常会使用 GtkRange::value-changed 信号。

请注意，使用相同的上限值和下限值（通过 GtkRange 方法）将隐藏滑动条本身。这对于希望在滚动条上显示不确定的值但又不想更改应用程序布局（例如电影或音乐播放器）的应用程序非常有用。

作为 GtkBuildable 的 GtkScale

GtkScale 支持自定义 <marks> 元素，其中可以包含多个 <mark\> 元素。“value”和“position”属性的含义与 gtk_scale_add_mark() 的同名参数相同。如果元素不为空，则将其内容视为标记处显示的标记。可以通过通常的“translatable”和“context”属性对其进行转换。

快捷键和手势

GtkPopoverMenu 支持以下键盘快捷键

箭头键、+ 和 - 会增大或减小步长，或与 Ctrl 组合后增大或减小页面。
PgUp 和 PgDn 会增大或减小页面。
Home 和 End 会设置最小值或最大值。

CSS 节点

scale[.fine-tune][.marks-before][.marks-after]
├── [value][.top][.right][.bottom][.left]
├── marks.top
│   ├── mark
│   ┊    ├── [label]
│   ┊    ╰── indicator
┊   ┊
│   ╰── mark
├── marks.bottom
│   ├── mark
│   ┊    ├── indicator
│   ┊    ╰── [label]
┊   ┊
│   ╰── mark
╰── trough
    ├── [fill]
    ├── [highlight]
    ╰── slider

GtkScale 有一个名称为 scale 的 CSS 主节点和一个 name 为 trough 和 slider 的内容子节点。

当滚动条处于“微调”模式时，主节点会添加 .fine-tune 样式类。

如果滚动条有原点（请参阅 gtk_scale_set_has_origin()），则在 trough 节点下方会有一个 name 为 highlight 的子节点，用于渲染 trough 的高亮部分。

如果比例尺显示填充级别（参见 gtk_range_set_show_fill_level()），将有名称为填充的子节点在槽节点下方，它用于渲染槽的填充部分。

如果存在标记，将在槽节点之前或之后出现标记子节点，每个标记将获得一个子节点，名称为标记。标记节点将获得 .top 或 .bottom style 样式类。

标记节点具有一个名为指示符的子节点。如果标记具有文本，它还将具有一个名为标签的子节点。当标记位于刻度的上方或左侧时，标签子节点在出现时是第一个。否则，指示符子节点是第一个。

主 CSS 节点根据存在哪些标记而获得“marks-before”和/或“marks-after”样式类的添加。

如果比例尺显示值（参见 GtkScale:draw-value），将有子节点以名称值显示。此节点将获得类似于标记节点的 .top 或 .bottom 样式类。

辅助功能

GtkScale 使用 GTK_ACCESSIBLE_ROLE_SLIDER 角色。

层次

祖先

实现

构造函数

gtk_scale_new

创建一个新的 GtkScale。

gtk_scale_new_with_range

创建范围从 min 到 max 的新比例尺小部件。

从 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

orientable 的方向。

信号

从 GObject（1）继承的信号

GObject::notify

当对象通过 g_object_set_property()、g_object_set() 等设置其属性值时，会发出 notify 信号。

类结构

struct GtkScaleClass {
  GtkRangeClass parent_class;
  void (* get_layout_offsets) (
    GtkScale* scale,
    int* x,
    int* y
  );
  
}

暂无描述。

类成员

parent_class: GtkRangeClass: 暂无描述。
get_layout_offsets: void (* get_layout_offsets) ( GtkScale* scale, int* x, int* y ): 暂无描述。

虚拟方法

Gtk.ScaleClass.get_layout_offsets

获取比例尺绘制表示比例尺中的文本的 PangoLayout 的坐标。

简介 [src]

作为 GtkBuildable 的 GtkScale

快捷键和手势

CSS 节点

辅助功能

层次

祖先

实现

构造函数

实例方法

方法继承自 GtkRange (22)

从 GtkWidget 继承的方法 (162)

从 GObject 继承的方法 (43)

从 GtkAccessible 继承的方法 (19)

从 GtkBuildable 继承的方法 (1)

从 GtkOrientable 继承的方法(2)

属性

从 GtkRange 继承的属性(6)

从 GtkWidget 继承的属性(34)

从 GtkAccessible（1）继承的属性

从 GtkOrientable（1）继承的属性

信号

从 GtkRange（4）继承的信号

从 GtkWidget（13）继承的信号