Range

继承了: Control < CanvasItem < Node < Object

继承者: EditorSpinSlider, ProgressBar, ScrollBar, Slider, SpinBox, TextureProgress

Abstract base class for range-based controls.

基于范围的控件的抽象基类。

描述

Range is a base class for Control nodes that change a floating-point value between a minimum and a maximum, using step and page, for example a ScrollBar.

范围是控制节点的基类，这些控制节点使用步进和页面在最小和最大之间更改浮点值，例如滚动条。

属性

boolallow_greaterfalseboolallow_lesserfalseboolexp_editfalsefloatmax_value100.0floatmin_value0.0floatpage0.0floatratio boolroundedfalsefloatstep1.0floatvalue0.0

方法

voidshare ( Node with )voidunshare ( )

信号

changed ( )

Emitted when min_value, max_value, page, or step change.

当min_value，max_value，page或step更改时发出。

---

value_changed ( float value )

Emitted when value changes.

当值更改时发出。

属性描述

bool allow_greater DefaultfalseSetterset_allow_greater(value)Getteris_greater_allowed()

If true, value may be greater than max_value.

如果为true，则值可能大于max_value。

---

bool allow_lesser DefaultfalseSetterset_allow_lesser(value)Getteris_lesser_allowed()

If true, value may be less than min_value.

如果为true，则值可能小于min_value。

---

bool exp_edit DefaultfalseSetterset_exp_ratio(value)Getteris_ratio_exp()

If true, and min_value is greater than 0, value will be represented exponentially rather than linearly.

如果true和min_value大于0，则value将以指数形式而不是线性形式表示。

---

float max_value Default100.0Setterset_max(value)Getterget_max()

Maximum value. Range is clamped if value is greater than max_value.

最大值。 如果值大于max_value，则会限制范围。

---

float min_value Default0.0Setterset_min(value)Getterget_min()

Minimum value. Range is clamped if value is less than min_value.

最小值。 如果值小于min_value，则会限制范围。

---

float page Default0.0Setterset_page(value)Getterget_page()

Page size. Used mainly for ScrollBar. ScrollBar's length is its size multiplied by page over the difference between min_value and max_value.

页面大小。 主要用于滚动条。 滚动条的长度是其大小乘以页面的最小值与最大值之间的差。

---

float ratio Setterset_as_ratio(value)Getterget_as_ratio()

The value mapped between 0 and 1.

该值映射在0和1之间。

---

bool rounded DefaultfalseSetterset_use_rounded_values(value)Getteris_using_rounded_values()

If true, value will always be rounded to the nearest integer.

如果为true，则值将始终四舍五入为最接近的整数。

---

float step Default1.0Setterset_step(value)Getterget_step()

If greater than 0, value will always be rounded to a multiple of step. If rounded is also true, value will first be rounded to a multiple of step then rounded to the nearest integer.

如果大于0，则值将始终四舍五入为步长的整数倍。 如果四舍五入也为true，则将值首先四舍五入为步长的整数倍，然后四舍五入为最接近的整数。

---

float value Default0.0Setterset_value(value)Getterget_value()

Range's current value.

范围的当前值。

方法描述

void share ( Node with )

Binds two ranges together along with any ranges previously grouped with either of them. When any of range's member variables change, it will share the new value with all other ranges in its group.

将两个范围以及之前与其中一个分组的任何范围绑定在一起。 当任何范围的成员变量更改时，它将与该组中的所有其他范围共享新值。

---

void unshare ( )

Stops range from sharing its member variables with any other.

阻止范围与其他任何成员共享其成员变量。