Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

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