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) 🔗

Викликається, коли змінюється значення елемента. При використанні на 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()

Якщо значення більше за 0.0, значення value завжди буде округлено до значення, кратного значенню цієї властивості, вище за min_value. Наприклад, якщо min_value дорівнює 0.1, а крок дорівнює 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, щоб поділитися змінами членів з будь-яким іншим.