GtkRange

描述 [src]

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

GtkRange 是可视化调整对象的通用基类。

派生自 GtkRange 的小部件包括 GtkScaleGtkScrollbar

除了用于监视调整对象的参数的信号外,GtkRange 还提供了可用于在范围小部件上设置“填充级”的属性和方法。请参阅 gtk_range_set_fill_level()

快捷键和手势

GtkRange 滚动条是可拖动的。在拖动时按住 Shift 键或通过长按启动拖动操作将启用微调模式。

层次结构

hierarchy this GtkRange implements_0 GtkAccessible this--implements_0 implements_1 GtkAccessibleRange this--implements_1 implements_2 GtkBuildable this--implements_2 implements_3 GtkConstraintTarget this--implements_3 implements_4 GtkOrientable this--implements_4 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

子代

实例方法

gtk_range_get_adjustment

获取作为 GtkRange 的“模型”对象的调整对象。

gtk_range_get_fill_level

获取填充级指示器的当前位置。

gtk_range_get_flippable

获取 GtkRange 是否会遵循文字方向。

gtk_range_get_inverted

获取范围是否翻转。

gtk_range_get_range_rect

此函数返回包含范围凹槽的区域,该区域以相对于 range 原点的坐标表示。

gtk_range_get_restrict_to_fill_level

获取范围是否限制在填充级别。

gtk_range_get_round_digits

获取当值发生更改时应该四舍五入保留的位数。

gtk_range_get_show_fill_level

获取范围是否以图形方式显示填充级别。

gtk_range_get_slider_range

此函数返回控件->窗口坐标系中,沿长维度方向滑块的范围。

gtk_range_get_slider_size_fixed

此函数主要对 `GtkRange` 子类有用。

gtk_range_get_value

获取范围的当前值。

gtk_range_set_adjustment

设置作为 `GtkRange` 的“模型”对象的调整。

gtk_range_set_fill_level

设置填充级别指示符的新位置。

gtk_range_set_flippable

设置是否让 `GtkRange` 遵循文本方向。

gtk_range_set_increments

设置范围的步长和分页大小。

gtk_range_set_inverted

设置是否反转范围。

gtk_range_set_range

设置 `GtkRange` 中允许的值。

gtk_range_set_restrict_to_fill_level

设置是否将滑块限制在填充级别。

gtk_range_set_round_digits

设置当值发生更改时应该四舍五入保留的位数。

gtk_range_set_show_fill_level

设置是否在滑轨上显示图形填充级别。

gtk_range_set_slider_size_fixed

设置范围的滑块是否具有固定大小,或者大小取决于其调整的分页大小。

gtk_range_set_value

设置范围的当前值。

从此继承的方法 GtkWidget (162)

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

从此继承的方法 GObject (43)

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

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

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

自版本:4.14 起提供

gtk_accessible_get_accessible_parent

检索一个无障碍对象的无障碍父元素。

自版本:4.10 起提供

gtk_accessible_get_accessible_role

检索一个无障碍对象的无障碍角色。

gtk_accessible_get_at_context

检索给定无障碍对象的实现。

自版本:4.10 起提供

gtk_accessible_get_bounds

查询此无障碍元素的坐标和维度。

自版本:4.10 起提供

gtk_accessible_get_first_accessible_child

检索一个无障碍对象的第一个无障碍子元素。

自版本:4.10 起提供

gtk_accessible_get_next_accessible_sibling

检索一个无障碍对象的下一个无障碍同级元素。

自版本:4.10 起提供

gtk_accessible_get_platform_state

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

自版本:4.10 起提供

gtk_accessible_reset_property

将无障碍属性重置为其默认值。

gtk_accessible_reset_relation

将无障碍关系重置为其默认值。

gtk_accessible_reset_state

将无障碍状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置一个无障碍对象的父元素和同级元素。

自版本:4.10 起提供

gtk_accessible_update_next_accessible_sibling

更新下一个无障碍同级元素。

自版本: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

从此继承的方法 GtkOrientable (2)
gtk_orientable_get_orientation

检索 orientable 的方向。

gtk_orientable_set_orientation

设置 orientable 的方向。

属性

Gtk.Range:adjustment

受范围(range)控制的调节器。

Gtk.Range:fill-level

填充级别(例如,网络流的预缓冲)。

Gtk.Range:inverted

如果为 TRUE,将反转滑块移动的方向。

Gtk.Range:restrict-to-fill-level

控制是否将滑块移动限制在填充级别设置的上限。

Gtk.Range:round-digits

当值改变时,将值四舍五入到的数字个数。

Gtk.Range:show-fill-level

控制在空间中是否显示填充级别指示器图形。

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 实现的可访问角色。

GtkOrientable 继承的属性(1 个)
GtkOrientable:orientation

可定向的定向。

信号

Gtk.Range::adjust-bounds

在限定值之前发出,以给应用程序调整边界的机会。

Gtk.Range::change-value

在对一系列动作执行滚动操作时发出。

Gtk.Range::move-slider

用以移动滑块的虚拟函数。

Gtk.Range::value-changed

在范围值发生改变时发出。

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

所有拥有对 widget 引用的人应该释放他们持有的引用信号。

GtkWidget::direction-changed

在 widget 的文字方向发生改变时发出。

GtkWidget::hide

widget 隐藏时发出。

GtkWidget::keynav-failed

发生键盘导航失败时发出。

GtkWidget::map

当将要映射 widget 时发出。

GtkWidget::mnemonic-activate

当通过助记符激活 widget 时发出。

GtkWidget::move-focus

当焦点移动时发出。

GtkWidget::query-tooltip

当 widget 的 tooltip 即将显示时发出。

GtkWidget::realize

widgetGdkSurface 关联时发出。

GtkWidget::show

widget 显示时发出。

GtkWidget::state-flags-changed

当 widget 状态发生改变时发出。

GtkWidget::unmap

当将要取消映射 widget 时发出。

GtkWidget::unrealize

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

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

当某个对象的某个属性通过 g_object_set_property()、g_object_set() 等函数被设置了新值时,就会发出 notify 信号。

类结构

struct GtkRangeClass {
  GtkWidgetClass parent_class;
  void (* value_changed) (
    GtkRange* range
  );
  void (* adjust_bounds) (
    GtkRange* range,
    double new_value
  );
  void (* move_slider) (
    GtkRange* range,
    GtkScrollType scroll
  );
  void (* get_range_border) (
    GtkRange* range,
    GtkBorder* border_
  );
  gboolean (* change_value) (
    GtkRange* range,
    GtkScrollType scroll,
    double new_value
  );
  
}

无可用描述。

类成员
parent_class: GtkWidgetClass

无可用描述。

value_changed: void (* value_changed) ( GtkRange* range )

无可用描述。

adjust_bounds: void (* adjust_bounds) ( GtkRange* range, double new_value )

无可用描述。

move_slider: void (* move_slider) ( GtkRange* range, GtkScrollType scroll )

无可用描述。

get_range_border: void (* get_range_border) ( GtkRange* range, GtkBorder* border_ )

无可用描述。

change_value: gboolean (* change_value) ( GtkRange* range, GtkScrollType scroll, double new_value )

无可用描述。

虚拟方法

Gtk.RangeClass.adjust_bounds
无可用描述。

Gtk.RangeClass.change_value
无可用描述。

Gtk.RangeClass.get_range_border
无可用描述。

Gtk.RangeClass.move_slider
无可用描述。

Gtk.RangeClass.value_changed
无可用描述。