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`

主题属性¶

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

信号¶

drag_ended ( bool value_changed )

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

drag_started ( )

拖拽开始时触发。

属性说明¶

bool editable = true

void set_editable ( bool value )
bool is_editable ( )

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

bool scrollable = true

void set_scrollable ( bool value )
bool is_scrollable ( )

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

int tick_count = 0

void set_ticks ( int value )
int get_ticks ( )

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

bool ticks_on_borders = false

void set_ticks_on_borders ( bool value )
bool get_ticks_on_borders ( )

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

主题属性说明¶

int center_grabber = 0

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

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