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...

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 的高度或宽度。