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(value_changed: bool) 🔗

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


drag_started() 🔗

拖拽开始时触发。触发时机在对应的 Range.value_changed 信号之前。


属性说明

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,则滑杆将显示最小值和最大值的刻度。


主题属性说明

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