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...
SpinBox
繼承： Range < Control < CanvasItem < Node < Object
數位的輸入欄位。
說明
SpinBox is a numerical input text field. It allows entering integers and floating-point numbers. The SpinBox also has up and down buttons that can be clicked to increase or decrease the value. The value can also be changed by dragging the mouse up or down over the SpinBox's arrows.
Additionally, mathematical expressions can be entered. These are evaluated when the user presses Enter while editing the SpinBox's text field. This uses the Expression class to parse and evaluate the expression. The result of the expression is then set as the value of the SpinBox. Some examples of valid expressions are 5 + 2 * 3, pow(2, 4), and PI + sin(0.5). Expressions are case-sensitive.
Example: Create a SpinBox, disable its context menu and set its text alignment to right.
var spin_box = SpinBox.new()
add_child(spin_box)
var line_edit = spin_box.get_line_edit()
line_edit.context_menu_enabled = false
spin_box.horizontal_alignment = LineEdit.HORIZONTAL_ALIGNMENT_RIGHT
var spinBox = new SpinBox();
AddChild(spinBox);
var lineEdit = spinBox.GetLineEdit();
lineEdit.ContextMenuEnabled = false;
spinBox.AlignHorizontal = LineEdit.HorizontalAlignEnum.Right;
See Range class for more options over the SpinBox.
Note: With the SpinBox's context menu disabled, you can right-click the bottom half of the spinbox to set the value to its minimum, while right-clicking the top half sets the value to its maximum.
Note: SpinBox relies on an underlying LineEdit node. To theme a SpinBox's background, add theme items for LineEdit and customize them. The LineEdit has the SpinBoxInnerLineEdit theme variation, so that you can give it a distinct appearance from regular LineEdits.
Note: If you want to implement drag and drop for the underlying LineEdit, you can use Control.set_drag_forwarding() on the node returned by get_line_edit().
屬性
|
||
|
||
|
||
|
||
|
||
|
||
BitField[SizeFlags] |
size_flags_vertical |
|
step |
|
|
|
||
|
方法
void |
apply() |
主題屬性
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
屬性說明
HorizontalAlignment alignment = 0 🔗
void set_horizontal_alignment(value: HorizontalAlignment)
HorizontalAlignment get_horizontal_alignment()
更改底層 LineEdit 的對齊方式。
bool custom_arrow_round = false 🔗
If true, the value will be rounded to a multiple of custom_arrow_step when interacting with the arrow buttons. Otherwise, increments the value by custom_arrow_step and then rounds it according to Range.step.
float custom_arrow_step = 0.0 🔗
If not 0, sets the step when interacting with the arrow buttons of the SpinBox.
Note: Range.value will still be rounded to a multiple of Range.step.
如果為 true，則 SpinBox 將是可編輯的。否則，它將是唯讀的。
Adds the specified prefix string before the numerical value of the SpinBox.
bool select_all_on_focus = false 🔗
如果為 true，則該 SpinBox 會在 LineEdit 獲得焦點時選中整個文本。點擊上下箭頭不會觸發這種行為。
Adds the specified suffix string after the numerical value of the SpinBox.
bool update_on_text_changed = false 🔗
Sets the value of the Range for this SpinBox when the LineEdit text is changed instead of submitted. See LineEdit.text_changed and LineEdit.text_submitted.
Note: If set to true, this will interfere with entering mathematical expressions in the SpinBox. The SpinBox will try to evaluate the expression as you type, which means symbols like a trailing + are removed immediately by the expression being evaluated.
方法說明
void apply() 🔗
Applies the current value of this SpinBox. This is equivalent to pressing Enter while editing the LineEdit used by the SpinBox. This will cause LineEdit.text_submitted to be emitted and its currently contained expression to be evaluated.
返回這個 SpinBox 中的 LineEdit 實例。你可以用它來存取 LineEdit 的屬性和方法。
警告：這是一個必要的內部節點，移除和釋放它可能會導致當機。如果你想隱藏它或它的任何子節點，請使用其 CanvasItem.visible 屬性。
主題屬性說明
Color down_disabled_icon_modulate = Color(0.875, 0.875, 0.875, 0.5) 🔗
Down button icon modulation color, when the button is disabled.
Color down_hover_icon_modulate = Color(0.95, 0.95, 0.95, 1) 🔗
Down button icon modulation color, when the button is hovered.
Color down_icon_modulate = Color(0.875, 0.875, 0.875, 1) 🔗
Down button icon modulation color.
Color down_pressed_icon_modulate = Color(0.95, 0.95, 0.95, 1) 🔗
Down button icon modulation color, when the button is being pressed.
Color up_disabled_icon_modulate = Color(0.875, 0.875, 0.875, 0.5) 🔗
Up button icon modulation color, when the button is disabled.
Color up_hover_icon_modulate = Color(0.95, 0.95, 0.95, 1) 🔗
Up button icon modulation color, when the button is hovered.
Color up_icon_modulate = Color(0.875, 0.875, 0.875, 1) 🔗
Up button icon modulation color.
Color up_pressed_icon_modulate = Color(0.95, 0.95, 0.95, 1) 🔗
Up button icon modulation color, when the button is being pressed.
int buttons_vertical_separation = 0 🔗
Vertical separation between the up and down buttons.
Width of the up and down buttons. If smaller than any icon set on the buttons, the respective icon may overlap neighboring elements. If smaller than 0, the width is automatically adjusted from the icon size.
int field_and_buttons_separation = 2 🔗
Width of the horizontal separation between the text input field (LineEdit) and the buttons.
int set_min_buttons_width_from_icons = 1 🔗
If not 0, the minimum button width corresponds to the widest of all icons set on those buttons, even if buttons_width is smaller.
Down button icon, displayed in the middle of the down (value-decreasing) button.
Down button icon when the button is disabled.
Down button icon when the button is hovered.
Down button icon when the button is being pressed.
Up button icon, displayed in the middle of the up (value-increasing) button.
Up button icon when the button is disabled.
Up button icon when the button is hovered.
Up button icon when the button is being pressed.
Single texture representing both the up and down buttons icons. It is displayed in the middle of the buttons and does not change upon interaction. If a valid icon is assigned, it will replace up and down.
Background style of the down button.
StyleBox down_background_disabled 🔗
Background style of the down button when disabled.
StyleBox down_background_hovered 🔗
Background style of the down button when hovered.
StyleBox down_background_pressed 🔗
Background style of the down button when being pressed.
StyleBox field_and_buttons_separator 🔗
StyleBox drawn in the space occupied by the separation between the input field and the buttons.
Background style of the up button.
StyleBox up_background_disabled 🔗
Background style of the up button when disabled.
StyleBox up_background_hovered 🔗
Background style of the up button when hovered.
StyleBox up_background_pressed 🔗
Background style of the up button when being pressed.
StyleBox up_down_buttons_separator 🔗
StyleBox drawn in the space occupied by the separation between the up and down buttons.