Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Range

Наследует: Control < CanvasItem < Node < Object

Наследуется от: EditorSpinSlider, ProgressBar, ScrollBar, Slider, SpinBox, TextureProgressBar

Абстрактный базовый класс для элементов управления, представляющих число в диапазоне.

Описание

Range — абстрактный базовый класс для элементов управления, представляющих число в диапазоне, с использованием настроенного размера step и page. См. например, ScrollBar и Slider для примеров узлов более высокого уровня, использующих Range.

Свойства

bool	allow_greater	`false`
bool	allow_lesser	`false`
bool	exp_edit	`false`
float	max_value	`100.0`
float	min_value	`0.0`
float	page	`0.0`
float	ratio
bool	rounded	`false`
BitField[SizeFlags]	size_flags_vertical	`0` (overrides Control)
float	step	`0.01`
float	value	`0.0`

Методы

void	_value_changed(new_value: float) virtual
void	set_value_no_signal(value: float)
void	share(with: Node)
void	unshare()

Сигналы

changed() 🔗

Выдается при изменении min_value, max_value, page или step.

value_changed(value: float) 🔗

Вызывается при изменении value. При использовании на Slider вызывается непрерывно во время перетаскивания (потенциально каждый кадр). Если вы выполняете затратную операцию в функции, подключенной к value_changed, рассмотрите возможность использования debouncing Timer, чтобы вызывать функцию реже.

Примечание: В отличие от сигналов, таких как LineEdit.text_changed, value_changed также вызывается, когда value устанавливается напрямую через код.

Описания свойств

bool allow_greater = false 🔗

void set_allow_greater(value: bool)
bool is_greater_allowed()

Если true, value может быть больше, чем max_value.

bool allow_lesser = false 🔗

void set_allow_lesser(value: bool)
bool is_lesser_allowed()

Если true, value может быть меньше, чем min_value.

bool exp_edit = false 🔗

void set_exp_ratio(value: bool)
bool is_ratio_exp()

Если true, а min_value больше или равно 0, value будет представлено экспоненциально, а не линейно.

float max_value = 100.0 🔗

void set_max(value: float)
float get_max()

Максимальное значение. Диапазон ограничивается, если value больше, чем max_value.

float min_value = 0.0 🔗

void set_min(value: float)
float get_min()

Минимальное значение. Диапазон ограничивается, если value меньше min_value.

float page = 0.0 🔗

void set_page(value: float)
float get_page()

Размер страницы. Используется в основном для ScrollBar. Длина захвата ScrollBar — это размер ScrollBar, умноженный на page и на разницу между min_value и max_value.

float ratio 🔗

void set_as_ratio(value: float)
float get_as_ratio()

Значение отображается в диапазоне от 0 до 1.

bool rounded = false 🔗

void set_use_rounded_values(value: bool)
bool is_using_rounded_values()

Если true, value всегда будет округляться до ближайшего целого числа.

float step = 0.01 🔗

void set_step(value: float)
float get_step()

Если значение параметра value больше 0.0, оно всегда будет округляться до кратного значения этого свойства, превышающего min_value. Например, если min_value равно 0.1, а step равно 0.2, то значение параметра value будет ограничено значениями 0.1, 0.3, 0.5 и так далее. Если rounded также равно true, значение параметра value сначала будет округляться до кратного значения этого свойства, а затем до ближайшего целого числа.

float value = 0.0 🔗

void set_value(value: float)
float get_value()

Текущее значение диапазона. Изменение этого свойства (даже через код) вызовет сигнал value_changed. Используйте set_value_no_signal(), если хотите этого избежать.

Описания метода

void _value_changed(new_value: float) virtual 🔗

Вызывается при изменении значения Range (при соблюдении тех же условий, что и value_changed).

void set_value_no_signal(value: float) 🔗

Устанавливает текущее значение Range на указанное value без передачи сигнала value_changed.

Связывает два Range вместе с любыми диапазонами, ранее сгруппированными с любым из них. Когда любая из переменных-членов диапазона изменяется, она поделится новым значением со всеми другими диапазонами в своей группе.

void unshare() 🔗

Запрещает Range совместно использовать свои переменные-члены с другими.