Up to date
This page is up to date for Godot 4.2
.
If you still find outdated information, please open an issue.
Range¶
Inherits: Control < CanvasItem < Node < Object
Inherited By: EditorSpinSlider, ProgressBar, ScrollBar, Slider, SpinBox, TextureProgressBar
Abstract base class for controls that represent a number within a range.
Description¶
Range is an abstract base class for controls that represent a number within a range, using a configured step and page size. See e.g. ScrollBar and Slider for examples of higher-level nodes using Range.
Properties¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
BitField<SizeFlags> |
size_flags_vertical |
|
|
||
|
Methods¶
void |
_value_changed ( float new_value ) virtual |
void |
set_value_no_signal ( float value ) |
void |
|
void |
unshare ( ) |
Signals¶
changed ( )
Emitted when min_value, max_value, page, or step change.
value_changed ( float value )
Emitted when value changes. When used on a Slider, this is called continuously while dragging (potentially every frame). If you are performing an expensive operation in a function connected to value_changed, consider using a debouncing Timer to call the function less often.
Note: Unlike signals such as LineEdit.text_changed, value_changed is also emitted when value
is set directly via code.
Property Descriptions¶
bool allow_greater = false
If true
, value may be greater than max_value.
bool allow_lesser = false
If true
, value may be less than min_value.
bool exp_edit = false
If true
, and min_value is greater than 0, value will be represented exponentially rather than linearly.
float max_value = 100.0
Maximum value. Range is clamped if value is greater than max_value.
float min_value = 0.0
Minimum value. Range is clamped if value is less than min_value.
float page = 0.0