Slider

继承： Range < Control < CanvasItem < Node < Object

派生： HSlider, VSlider

滑块的抽象基类。

描述

滑块的抽象基类，通过将抓取器（滑块）沿水平轴或垂直轴移动类调整取值。滑块是基于 Range 的控件。

属性

bool	editable	true
FocusMode	focus_mode	2 (overrides Control)
bool	scrollable	true
float	step	1.0 (overrides Range)
int	tick_count	0
bool	ticks_on_borders	false
TickPosition	ticks_position	0

主题属性

int	center_grabber	0
int	grabber_offset	0
int	tick_offset	0
Texture2D	grabber
Texture2D	grabber_disabled
Texture2D	grabber_highlight
Texture2D	tick
StyleBox	grabber_area
StyleBox	grabber_area_highlight
StyleBox	slider

---

信号

drag_ended(value_changed: bool) 🔗

停止拖拽拖动器时发出。如果 value_changed 为 true，则 Range.value 与开始拖拽时的值不同。

---

drag_started() 🔗

开始拖拽拖动器时发出，时机在对应的 Range.value_changed 信号之前。

---

枚举

enum TickPosition: 🔗

TickPosition TICK_POSITION_BOTTOM_RIGHT = 0

将刻度放置在 HSlider 的底部、VSlider 的右侧。

TickPosition TICK_POSITION_TOP_LEFT = 1

将刻度放置在 HSlider 的顶部、VSlider 的左侧。

TickPosition TICK_POSITION_BOTH = 2

在滑杆的两侧放置刻度。

TickPosition TICK_POSITION_CENTER = 3

在滑杆的中间放置刻度。

---

属性说明

bool editable = true 🔗

• void set_editable(value: bool)

• bool is_editable()

如果为 true，则滑块可以交互。如果为 false，则只能通过代码更改该值。

---

bool scrollable = true 🔗

• void set_scrollable(value: bool)

• bool is_scrollable()

如果为 true，则可以使用鼠标滚轮更改该值。

---

int tick_count = 0 🔗

• void set_ticks(value: int)

• int get_ticks()

滑杆上显示的刻度线数量，包括边界刻度线。刻度是均匀分布的数值标记。

---

bool ticks_on_borders = false 🔗

• void set_ticks_on_borders(value: bool)

• bool get_ticks_on_borders()

如果为 true，则滑杆将显示最小值和最大值的刻度。

---

TickPosition ticks_position = 0 🔗

• void set_ticks_position(value: TickPosition)

• TickPosition get_ticks_position()

设置刻度的位置。详见 TickPosition。

---

主题属性说明

int center_grabber = 0 🔗

布尔常量。如果为 1，则会忽略抓取器纹理的大小，根据其中心位置将其缩放到滑杆的边界。

---

int grabber_offset = 0 🔗

抓取器的垂直或水平偏移量。

---

int tick_offset = 0 🔗

刻度的垂直或水平偏移量。顶部和左侧刻度的偏移量是反的。

---

Texture2D grabber 🔗

用作拖动条的纹理（可拖动的元素）。

---

Texture2D grabber_disabled 🔗

抓取器禁用时的材质。

---

Texture2D grabber_highlight 🔗

抓取器获得焦点时的材质。

---

Texture2D tick 🔗

刻度的纹理。当 tick_count 大于 0 时可见。

---

StyleBox grabber_area 🔗

抓取器左侧或底部区域的背景。

---

StyleBox grabber_area_highlight 🔗

抓取器被悬停或聚焦时，显示的左侧或底部区域的背景。

---

StyleBox slider 🔗

整个滑杆的背景。影响 grabber_area 的高度或宽度。