mirror of
https://github.com/godotengine/godot.git
synced 2024-12-09 10:09:20 +08:00
b68dd2e189
This makes it easier to spot syntax errors when editing the class reference. The schema is referenced locally so validation can still work offline. Each class XML's schema conformance is also checked on GitHub Actions.
68 lines
3.1 KiB
XML
68 lines
3.1 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="SpinBox" inherits="Range" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Numerical input text field.
|
|
</brief_description>
|
|
<description>
|
|
SpinBox is a numerical input text field. It allows entering integers and floats.
|
|
[b]Example:[/b]
|
|
[codeblocks]
|
|
[gdscript]
|
|
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
|
|
[/gdscript]
|
|
[csharp]
|
|
var spinBox = new SpinBox();
|
|
AddChild(spinBox);
|
|
var lineEdit = spinBox.GetLineEdit();
|
|
lineEdit.ContextMenuEnabled = false;
|
|
spinBox.AlignHorizontal = LineEdit.HorizontalAlignEnum.Right;
|
|
[/csharp]
|
|
[/codeblocks]
|
|
The above code will create a [SpinBox], disable context menu on it and set the text alignment to right.
|
|
See [Range] class for more options over the [SpinBox].
|
|
[b]Note:[/b] [SpinBox] relies on an underlying [LineEdit] node. To theme a [SpinBox]'s background, add theme items for [LineEdit] and customize them.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="apply">
|
|
<return type="void" />
|
|
<description>
|
|
Applies the current value of this [SpinBox].
|
|
</description>
|
|
</method>
|
|
<method name="get_line_edit">
|
|
<return type="LineEdit" />
|
|
<description>
|
|
Returns the [LineEdit] instance from this [SpinBox]. You can use it to access properties and methods of [LineEdit].
|
|
[b]Warning:[/b] This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their [member CanvasItem.visible] property.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="alignment" type="int" setter="set_horizontal_alignment" getter="get_horizontal_alignment" enum="HorizontalAlignment" default="0">
|
|
</member>
|
|
<member name="editable" type="bool" setter="set_editable" getter="is_editable" default="true">
|
|
If [code]true[/code], the [SpinBox] will be editable. Otherwise, it will be read only.
|
|
</member>
|
|
<member name="prefix" type="String" setter="set_prefix" getter="get_prefix" default="""">
|
|
Adds the specified [code]prefix[/code] string before the numerical value of the [SpinBox].
|
|
</member>
|
|
<member name="suffix" type="String" setter="set_suffix" getter="get_suffix" default="""">
|
|
Adds the specified [code]suffix[/code] string after the numerical value of the [SpinBox].
|
|
</member>
|
|
<member name="update_on_text_changed" type="bool" setter="set_update_on_text_changed" getter="get_update_on_text_changed" default="false">
|
|
Sets the value of the [Range] for this [SpinBox] when the [LineEdit] text is [i]changed[/i] instead of [i]submitted[/i]. See [signal LineEdit.text_changed] and [signal LineEdit.text_submitted].
|
|
</member>
|
|
</members>
|
|
<theme_items>
|
|
<theme_item name="updown" data_type="icon" type="Texture2D">
|
|
Sets a custom [Texture2D] for up and down arrows of the [SpinBox].
|
|
</theme_item>
|
|
</theme_items>
|
|
</class>
|