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

EditorSpinSlider

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

Godot 编辑器用于编辑数值的控件。

描述

这个 Control 节点在编辑器的检查器面板中使用，允许编辑数值。可以与 EditorInspectorPlugin 一起使用，以重新创建相同的行为。

如果 Range.step 值为 1，则 EditorSpinSlider 将显示向上/向下箭头，类似于 SpinBox。如果 Range.step 值不是 1，则会显示一个滑块。

属性

ControlState

control_state

0

bool

deferred_drag_mode

false

bool

editing_integer

false

bool

flat

false

FocusMode

focus_mode

2 (overrides Control)

bool

hide_slider

false

String

label

""

bool

read_only

false

BitField[SizeFlags]

size_flags_vertical

1 (overrides Control)

float

step

1.0 (overrides Range)

String

suffix

""

主题属性

Texture2D

updown

Texture2D

updown_disabled

信号

grabbed() 🔗

当微调器/滑块被抓取时发出。

ungrabbed() 🔗

当微调器/滑块取消抓取时发出。

updown_pressed() 🔗

当按下上下按钮时发出。

value_focus_entered() 🔗

值表单获得焦点时发出。

value_focus_exited() 🔗

值表单丢失焦点时发出。

枚举

enum ControlState: 🔗

ControlState CONTROL_STATE_DEFAULT = 0

使用的控件类型取决于 editing_integer 的值。如果为 true，则使用上下箭头；如果为 false，则使用滑杆。

ControlState CONTROL_STATE_PREFER_SLIDER = 1

即使启用了 editing_integer，也会始终使用滑杆。

ControlState CONTROL_STATE_HIDE = 2

向上向下箭头和滑杆都不会显示。

属性说明

ControlState control_state = 0 🔗

用于操纵值的控件将处于的状态。

bool deferred_drag_mode = false 🔗

  • void set_deferred_drag_mode_enabled(value: bool)

  • bool is_deferred_drag_mode_enabled()

如果为 true，则通过拖拽进行的更改仅在输入结束时生效（例如，当用户松开鼠标按钮时）。

bool editing_integer = false 🔗

  • void set_editing_integer(value: bool)

  • bool is_editing_integer()

如果为 true，则 EditorSpinSlider 会认为正在编辑整数值。如果为 false，则 EditorSpinSlider 会认为正在编辑浮点数值。默认用于确定是否绘制滑杆。只有浮点数才会绘制滑杆；整数使用的是类似于 SpinBox 的上下箭头，除非 control_state 被设置为 CONTROL_STATE_PREFER_SLIDER。如果滑杆可用，它还将使用 EditorSettings.interface/inspector/integer_drag_speed 而非 EditorSettings.interface/inspector/float_drag_speed。

bool flat = false 🔗

  • void set_flat(value: bool)

  • bool is_flat()

如果为 true，则滑块不会绘制背景。

bool hide_slider = false 🔗

  • void set_hide_slider(value: bool)

  • bool is_hiding_slider()

已弃用： Use control_state instead.

如果为 true，则隐藏滑块和向上/向下箭头。

String label = "" 🔗

在值的左侧显示的文本。

bool read_only = false 🔗

  • void set_read_only(value: bool)

  • bool is_read_only()

如果为 true，则无法与滑块交互。

String suffix = "" 🔗

在值之后显示的后缀（以一种淡化的颜色显示）。这通常应该是一个复数形式的词。如果后缀太长而无法显示，可能必须使用缩写。

主题属性说明

Texture2D updown 🔗

代表上下按钮的单张纹理。

Texture2D updown_disabled 🔗

控件只读或禁用时，代表上下按钮的单张纹理。