Range

Hereda: Control < CanvasItem < Node < Object

Heredado por: EditorSpinSlider, ProgressBar, ScrollBar, Slider, SpinBox, TextureProgressBar

Clase base abstracta para controles que representan un número dentro de un rango.

Descripción

Range es una clase base abstracta para controles que representan un número dentro de un rango, usando un tamaño de step y page configurado. Ver por ejemplo ScrollBar y Slider para ver ejemplos de nodos de nivel superior que usan Range.

Propiedades

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`

Métodos

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

Señales

changed() 🔗

Emitida cuando min_value, max_value, page o step cambian.

value_changed(value: float) 🔗

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.

Descripciones de Propiedades

bool allow_greater = false 🔗

void set_allow_greater(value: bool)
bool is_greater_allowed()

Si es true, value puede ser mayor que max_value.

bool allow_lesser = false 🔗

void set_allow_lesser(value: bool)
bool is_lesser_allowed()

Si es true, value puede ser menor que min_value.

bool exp_edit = false 🔗

void set_exp_ratio(value: bool)
bool is_ratio_exp()

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

float max_value = 100.0 🔗

void set_max(value: float)
float get_max()

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

float min_value = 0.0 🔗

void set_min(value: float)
float get_min()

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

float page = 0.0 🔗

void set_page(value: float)
float get_page()

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

float ratio 🔗

void set_as_ratio(value: float)
float get_as_ratio()

El valor asignado entre 0 y 1.

bool rounded = false 🔗

void set_use_rounded_values(value: bool)
bool is_using_rounded_values()

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

float step = 0.01 🔗

void set_step(value: float)
float get_step()

If greater than 0, value will always be rounded to a multiple of this property's value above min_value. For example, if min_value is 0.1 and step is 0.2, then value is limited to 0.1, 0.3, 0.5, and so on. If rounded is also true, value will first be rounded to a multiple of this property's value, then rounded to the nearest integer.

float value = 0.0 🔗

void set_value(value: float)
float get_value()

Range's current value. Changing this property (even via code) will trigger value_changed signal. Use set_value_no_signal() if you want to avoid it.

Descripciones de Métodos

void _value_changed(new_value: float) virtual 🔗

Se llama cuando el valor del Range cambia (siguiendo las mismas condiciones que la señal value_changed).

void set_value_no_signal(value: float) 🔗

Establece el valor actual del Range al value especificado, sin emitir la señal value_changed.

Vincula dos Ranges entre sí, junto con cualquier rango previamente agrupado con cualquiera de ellos. Cuando cualquiera de las variables miembro de un rango cambia, compartirá el nuevo valor con todos los demás rangos de su grupo.

void unshare() 🔗

Hace que el Range deje de compartir sus variables miembro con cualquier otro.