class_spinbox.rst 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712
  1. :github_url: hide
  2. .. meta::
  3. :keywords: number, numeric, input
  4. .. DO NOT EDIT THIS FILE!!!
  5. .. Generated automatically from Godot engine sources.
  6. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  7. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/SpinBox.xml.
  8. .. _class_SpinBox:
  9. SpinBox
  10. =======
  11. **Inherits:** :ref:`Range<class_Range>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  12. An input field for numbers.
  13. .. rst-class:: classref-introduction-group
  14. Description
  15. -----------
  16. **SpinBox** is a numerical input text field. It allows entering integers and floating-point numbers.
  17. \ **Example:** Create a **SpinBox**, disable its context menu and set its text alignment to right.
  18. .. tabs::
  19. .. code-tab:: gdscript
  20. var spin_box = SpinBox.new()
  21. add_child(spin_box)
  22. var line_edit = spin_box.get_line_edit()
  23. line_edit.context_menu_enabled = false
  24. spin_box.horizontal_alignment = LineEdit.HORIZONTAL_ALIGNMENT_RIGHT
  25. .. code-tab:: csharp
  26. var spinBox = new SpinBox();
  27. AddChild(spinBox);
  28. var lineEdit = spinBox.GetLineEdit();
  29. lineEdit.ContextMenuEnabled = false;
  30. spinBox.AlignHorizontal = LineEdit.HorizontalAlignEnum.Right;
  31. See :ref:`Range<class_Range>` class for more options over the **SpinBox**.
  32. \ **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.
  33. \ **Note:** **SpinBox** relies on an underlying :ref:`LineEdit<class_LineEdit>` node. To theme a **SpinBox**'s background, add theme items for :ref:`LineEdit<class_LineEdit>` and customize them. The :ref:`LineEdit<class_LineEdit>` has the ``SpinBoxInnerLineEdit`` theme variation, so that you can give it a distinct appearance from regular :ref:`LineEdit<class_LineEdit>`\ s.
  34. \ **Note:** If you want to implement drag and drop for the underlying :ref:`LineEdit<class_LineEdit>`, you can use :ref:`Control.set_drag_forwarding()<class_Control_method_set_drag_forwarding>` on the node returned by :ref:`get_line_edit()<class_SpinBox_method_get_line_edit>`.
  35. .. rst-class:: classref-reftable-group
  36. Properties
  37. ----------
  38. .. table::
  39. :widths: auto
  40. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  41. | :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`alignment<class_SpinBox_property_alignment>` | ``0`` |
  42. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  43. | :ref:`float<class_float>` | :ref:`custom_arrow_step<class_SpinBox_property_custom_arrow_step>` | ``0.0`` |
  44. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  45. | :ref:`bool<class_bool>` | :ref:`editable<class_SpinBox_property_editable>` | ``true`` |
  46. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  47. | :ref:`String<class_String>` | :ref:`prefix<class_SpinBox_property_prefix>` | ``""`` |
  48. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  49. | :ref:`bool<class_bool>` | :ref:`select_all_on_focus<class_SpinBox_property_select_all_on_focus>` | ``false`` |
  50. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  51. | |bitfield|\[:ref:`SizeFlags<enum_Control_SizeFlags>`\] | size_flags_vertical | ``1`` (overrides :ref:`Control<class_Control_property_size_flags_vertical>`) |
  52. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  53. | :ref:`float<class_float>` | step | ``1.0`` (overrides :ref:`Range<class_Range_property_step>`) |
  54. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  55. | :ref:`String<class_String>` | :ref:`suffix<class_SpinBox_property_suffix>` | ``""`` |
  56. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  57. | :ref:`bool<class_bool>` | :ref:`update_on_text_changed<class_SpinBox_property_update_on_text_changed>` | ``false`` |
  58. +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+
  59. .. rst-class:: classref-reftable-group
  60. Methods
  61. -------
  62. .. table::
  63. :widths: auto
  64. +---------------------------------+----------------------------------------------------------------+
  65. | |void| | :ref:`apply<class_SpinBox_method_apply>`\ (\ ) |
  66. +---------------------------------+----------------------------------------------------------------+
  67. | :ref:`LineEdit<class_LineEdit>` | :ref:`get_line_edit<class_SpinBox_method_get_line_edit>`\ (\ ) |
  68. +---------------------------------+----------------------------------------------------------------+
  69. .. rst-class:: classref-reftable-group
  70. Theme Properties
  71. ----------------
  72. .. table::
  73. :widths: auto
  74. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  75. | :ref:`Color<class_Color>` | :ref:`down_disabled_icon_modulate<class_SpinBox_theme_color_down_disabled_icon_modulate>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  76. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  77. | :ref:`Color<class_Color>` | :ref:`down_hover_icon_modulate<class_SpinBox_theme_color_down_hover_icon_modulate>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  78. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  79. | :ref:`Color<class_Color>` | :ref:`down_icon_modulate<class_SpinBox_theme_color_down_icon_modulate>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  80. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  81. | :ref:`Color<class_Color>` | :ref:`down_pressed_icon_modulate<class_SpinBox_theme_color_down_pressed_icon_modulate>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  82. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  83. | :ref:`Color<class_Color>` | :ref:`up_disabled_icon_modulate<class_SpinBox_theme_color_up_disabled_icon_modulate>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  84. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  85. | :ref:`Color<class_Color>` | :ref:`up_hover_icon_modulate<class_SpinBox_theme_color_up_hover_icon_modulate>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  86. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  87. | :ref:`Color<class_Color>` | :ref:`up_icon_modulate<class_SpinBox_theme_color_up_icon_modulate>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  88. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  89. | :ref:`Color<class_Color>` | :ref:`up_pressed_icon_modulate<class_SpinBox_theme_color_up_pressed_icon_modulate>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  90. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  91. | :ref:`int<class_int>` | :ref:`buttons_vertical_separation<class_SpinBox_theme_constant_buttons_vertical_separation>` | ``0`` |
  92. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  93. | :ref:`int<class_int>` | :ref:`buttons_width<class_SpinBox_theme_constant_buttons_width>` | ``16`` |
  94. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  95. | :ref:`int<class_int>` | :ref:`field_and_buttons_separation<class_SpinBox_theme_constant_field_and_buttons_separation>` | ``2`` |
  96. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  97. | :ref:`int<class_int>` | :ref:`set_min_buttons_width_from_icons<class_SpinBox_theme_constant_set_min_buttons_width_from_icons>` | ``1`` |
  98. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  99. | :ref:`Texture2D<class_Texture2D>` | :ref:`down<class_SpinBox_theme_icon_down>` | |
  100. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  101. | :ref:`Texture2D<class_Texture2D>` | :ref:`down_disabled<class_SpinBox_theme_icon_down_disabled>` | |
  102. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  103. | :ref:`Texture2D<class_Texture2D>` | :ref:`down_hover<class_SpinBox_theme_icon_down_hover>` | |
  104. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  105. | :ref:`Texture2D<class_Texture2D>` | :ref:`down_pressed<class_SpinBox_theme_icon_down_pressed>` | |
  106. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  107. | :ref:`Texture2D<class_Texture2D>` | :ref:`up<class_SpinBox_theme_icon_up>` | |
  108. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  109. | :ref:`Texture2D<class_Texture2D>` | :ref:`up_disabled<class_SpinBox_theme_icon_up_disabled>` | |
  110. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  111. | :ref:`Texture2D<class_Texture2D>` | :ref:`up_hover<class_SpinBox_theme_icon_up_hover>` | |
  112. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  113. | :ref:`Texture2D<class_Texture2D>` | :ref:`up_pressed<class_SpinBox_theme_icon_up_pressed>` | |
  114. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  115. | :ref:`Texture2D<class_Texture2D>` | :ref:`updown<class_SpinBox_theme_icon_updown>` | |
  116. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  117. | :ref:`StyleBox<class_StyleBox>` | :ref:`down_background<class_SpinBox_theme_style_down_background>` | |
  118. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  119. | :ref:`StyleBox<class_StyleBox>` | :ref:`down_background_disabled<class_SpinBox_theme_style_down_background_disabled>` | |
  120. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  121. | :ref:`StyleBox<class_StyleBox>` | :ref:`down_background_hovered<class_SpinBox_theme_style_down_background_hovered>` | |
  122. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  123. | :ref:`StyleBox<class_StyleBox>` | :ref:`down_background_pressed<class_SpinBox_theme_style_down_background_pressed>` | |
  124. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  125. | :ref:`StyleBox<class_StyleBox>` | :ref:`field_and_buttons_separator<class_SpinBox_theme_style_field_and_buttons_separator>` | |
  126. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  127. | :ref:`StyleBox<class_StyleBox>` | :ref:`up_background<class_SpinBox_theme_style_up_background>` | |
  128. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  129. | :ref:`StyleBox<class_StyleBox>` | :ref:`up_background_disabled<class_SpinBox_theme_style_up_background_disabled>` | |
  130. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  131. | :ref:`StyleBox<class_StyleBox>` | :ref:`up_background_hovered<class_SpinBox_theme_style_up_background_hovered>` | |
  132. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  133. | :ref:`StyleBox<class_StyleBox>` | :ref:`up_background_pressed<class_SpinBox_theme_style_up_background_pressed>` | |
  134. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  135. | :ref:`StyleBox<class_StyleBox>` | :ref:`up_down_buttons_separator<class_SpinBox_theme_style_up_down_buttons_separator>` | |
  136. +-----------------------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------+
  137. .. rst-class:: classref-section-separator
  138. ----
  139. .. rst-class:: classref-descriptions-group
  140. Property Descriptions
  141. ---------------------
  142. .. _class_SpinBox_property_alignment:
  143. .. rst-class:: classref-property
  144. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **alignment** = ``0`` :ref:`๐Ÿ”—<class_SpinBox_property_alignment>`
  145. .. rst-class:: classref-property-setget
  146. - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>`\ )
  147. - :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_horizontal_alignment**\ (\ )
  148. Changes the alignment of the underlying :ref:`LineEdit<class_LineEdit>`.
  149. .. rst-class:: classref-item-separator
  150. ----
  151. .. _class_SpinBox_property_custom_arrow_step:
  152. .. rst-class:: classref-property
  153. :ref:`float<class_float>` **custom_arrow_step** = ``0.0`` :ref:`๐Ÿ”—<class_SpinBox_property_custom_arrow_step>`
  154. .. rst-class:: classref-property-setget
  155. - |void| **set_custom_arrow_step**\ (\ value\: :ref:`float<class_float>`\ )
  156. - :ref:`float<class_float>` **get_custom_arrow_step**\ (\ )
  157. If not ``0``, :ref:`Range.value<class_Range_property_value>` will always be rounded to a multiple of :ref:`custom_arrow_step<class_SpinBox_property_custom_arrow_step>` when interacting with the arrow buttons of the **SpinBox**.
  158. .. rst-class:: classref-item-separator
  159. ----
  160. .. _class_SpinBox_property_editable:
  161. .. rst-class:: classref-property
  162. :ref:`bool<class_bool>` **editable** = ``true`` :ref:`๐Ÿ”—<class_SpinBox_property_editable>`
  163. .. rst-class:: classref-property-setget
  164. - |void| **set_editable**\ (\ value\: :ref:`bool<class_bool>`\ )
  165. - :ref:`bool<class_bool>` **is_editable**\ (\ )
  166. If ``true``, the **SpinBox** will be editable. Otherwise, it will be read only.
  167. .. rst-class:: classref-item-separator
  168. ----
  169. .. _class_SpinBox_property_prefix:
  170. .. rst-class:: classref-property
  171. :ref:`String<class_String>` **prefix** = ``""`` :ref:`๐Ÿ”—<class_SpinBox_property_prefix>`
  172. .. rst-class:: classref-property-setget
  173. - |void| **set_prefix**\ (\ value\: :ref:`String<class_String>`\ )
  174. - :ref:`String<class_String>` **get_prefix**\ (\ )
  175. Adds the specified prefix string before the numerical value of the **SpinBox**.
  176. .. rst-class:: classref-item-separator
  177. ----
  178. .. _class_SpinBox_property_select_all_on_focus:
  179. .. rst-class:: classref-property
  180. :ref:`bool<class_bool>` **select_all_on_focus** = ``false`` :ref:`๐Ÿ”—<class_SpinBox_property_select_all_on_focus>`
  181. .. rst-class:: classref-property-setget
  182. - |void| **set_select_all_on_focus**\ (\ value\: :ref:`bool<class_bool>`\ )
  183. - :ref:`bool<class_bool>` **is_select_all_on_focus**\ (\ )
  184. If ``true``, the **SpinBox** will select the whole text when the :ref:`LineEdit<class_LineEdit>` gains focus. Clicking the up and down arrows won't trigger this behavior.
  185. .. rst-class:: classref-item-separator
  186. ----
  187. .. _class_SpinBox_property_suffix:
  188. .. rst-class:: classref-property
  189. :ref:`String<class_String>` **suffix** = ``""`` :ref:`๐Ÿ”—<class_SpinBox_property_suffix>`
  190. .. rst-class:: classref-property-setget
  191. - |void| **set_suffix**\ (\ value\: :ref:`String<class_String>`\ )
  192. - :ref:`String<class_String>` **get_suffix**\ (\ )
  193. Adds the specified suffix string after the numerical value of the **SpinBox**.
  194. .. rst-class:: classref-item-separator
  195. ----
  196. .. _class_SpinBox_property_update_on_text_changed:
  197. .. rst-class:: classref-property
  198. :ref:`bool<class_bool>` **update_on_text_changed** = ``false`` :ref:`๐Ÿ”—<class_SpinBox_property_update_on_text_changed>`
  199. .. rst-class:: classref-property-setget
  200. - |void| **set_update_on_text_changed**\ (\ value\: :ref:`bool<class_bool>`\ )
  201. - :ref:`bool<class_bool>` **get_update_on_text_changed**\ (\ )
  202. Sets the value of the :ref:`Range<class_Range>` for this **SpinBox** when the :ref:`LineEdit<class_LineEdit>` text is *changed* instead of *submitted*. See :ref:`LineEdit.text_changed<class_LineEdit_signal_text_changed>` and :ref:`LineEdit.text_submitted<class_LineEdit_signal_text_submitted>`.
  203. .. rst-class:: classref-section-separator
  204. ----
  205. .. rst-class:: classref-descriptions-group
  206. Method Descriptions
  207. -------------------
  208. .. _class_SpinBox_method_apply:
  209. .. rst-class:: classref-method
  210. |void| **apply**\ (\ ) :ref:`๐Ÿ”—<class_SpinBox_method_apply>`
  211. Applies the current value of this **SpinBox**.
  212. .. rst-class:: classref-item-separator
  213. ----
  214. .. _class_SpinBox_method_get_line_edit:
  215. .. rst-class:: classref-method
  216. :ref:`LineEdit<class_LineEdit>` **get_line_edit**\ (\ ) :ref:`๐Ÿ”—<class_SpinBox_method_get_line_edit>`
  217. Returns the :ref:`LineEdit<class_LineEdit>` instance from this **SpinBox**. You can use it to access properties and methods of :ref:`LineEdit<class_LineEdit>`.
  218. \ **Warning:** 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 :ref:`CanvasItem.visible<class_CanvasItem_property_visible>` property.
  219. .. rst-class:: classref-section-separator
  220. ----
  221. .. rst-class:: classref-descriptions-group
  222. Theme Property Descriptions
  223. ---------------------------
  224. .. _class_SpinBox_theme_color_down_disabled_icon_modulate:
  225. .. rst-class:: classref-themeproperty
  226. :ref:`Color<class_Color>` **down_disabled_icon_modulate** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_down_disabled_icon_modulate>`
  227. Down button icon modulation color, when the button is disabled.
  228. .. rst-class:: classref-item-separator
  229. ----
  230. .. _class_SpinBox_theme_color_down_hover_icon_modulate:
  231. .. rst-class:: classref-themeproperty
  232. :ref:`Color<class_Color>` **down_hover_icon_modulate** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_down_hover_icon_modulate>`
  233. Down button icon modulation color, when the button is hovered.
  234. .. rst-class:: classref-item-separator
  235. ----
  236. .. _class_SpinBox_theme_color_down_icon_modulate:
  237. .. rst-class:: classref-themeproperty
  238. :ref:`Color<class_Color>` **down_icon_modulate** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_down_icon_modulate>`
  239. Down button icon modulation color.
  240. .. rst-class:: classref-item-separator
  241. ----
  242. .. _class_SpinBox_theme_color_down_pressed_icon_modulate:
  243. .. rst-class:: classref-themeproperty
  244. :ref:`Color<class_Color>` **down_pressed_icon_modulate** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_down_pressed_icon_modulate>`
  245. Down button icon modulation color, when the button is being pressed.
  246. .. rst-class:: classref-item-separator
  247. ----
  248. .. _class_SpinBox_theme_color_up_disabled_icon_modulate:
  249. .. rst-class:: classref-themeproperty
  250. :ref:`Color<class_Color>` **up_disabled_icon_modulate** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_up_disabled_icon_modulate>`
  251. Up button icon modulation color, when the button is disabled.
  252. .. rst-class:: classref-item-separator
  253. ----
  254. .. _class_SpinBox_theme_color_up_hover_icon_modulate:
  255. .. rst-class:: classref-themeproperty
  256. :ref:`Color<class_Color>` **up_hover_icon_modulate** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_up_hover_icon_modulate>`
  257. Up button icon modulation color, when the button is hovered.
  258. .. rst-class:: classref-item-separator
  259. ----
  260. .. _class_SpinBox_theme_color_up_icon_modulate:
  261. .. rst-class:: classref-themeproperty
  262. :ref:`Color<class_Color>` **up_icon_modulate** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_up_icon_modulate>`
  263. Up button icon modulation color.
  264. .. rst-class:: classref-item-separator
  265. ----
  266. .. _class_SpinBox_theme_color_up_pressed_icon_modulate:
  267. .. rst-class:: classref-themeproperty
  268. :ref:`Color<class_Color>` **up_pressed_icon_modulate** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`๐Ÿ”—<class_SpinBox_theme_color_up_pressed_icon_modulate>`
  269. Up button icon modulation color, when the button is being pressed.
  270. .. rst-class:: classref-item-separator
  271. ----
  272. .. _class_SpinBox_theme_constant_buttons_vertical_separation:
  273. .. rst-class:: classref-themeproperty
  274. :ref:`int<class_int>` **buttons_vertical_separation** = ``0`` :ref:`๐Ÿ”—<class_SpinBox_theme_constant_buttons_vertical_separation>`
  275. Vertical separation between the up and down buttons.
  276. .. rst-class:: classref-item-separator
  277. ----
  278. .. _class_SpinBox_theme_constant_buttons_width:
  279. .. rst-class:: classref-themeproperty
  280. :ref:`int<class_int>` **buttons_width** = ``16`` :ref:`๐Ÿ”—<class_SpinBox_theme_constant_buttons_width>`
  281. 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.
  282. .. rst-class:: classref-item-separator
  283. ----
  284. .. _class_SpinBox_theme_constant_field_and_buttons_separation:
  285. .. rst-class:: classref-themeproperty
  286. :ref:`int<class_int>` **field_and_buttons_separation** = ``2`` :ref:`๐Ÿ”—<class_SpinBox_theme_constant_field_and_buttons_separation>`
  287. Width of the horizontal separation between the text input field (:ref:`LineEdit<class_LineEdit>`) and the buttons.
  288. .. rst-class:: classref-item-separator
  289. ----
  290. .. _class_SpinBox_theme_constant_set_min_buttons_width_from_icons:
  291. .. rst-class:: classref-themeproperty
  292. :ref:`int<class_int>` **set_min_buttons_width_from_icons** = ``1`` :ref:`๐Ÿ”—<class_SpinBox_theme_constant_set_min_buttons_width_from_icons>`
  293. If not ``0``, the minimum button width corresponds to the widest of all icons set on those buttons, even if :ref:`buttons_width<class_SpinBox_theme_constant_buttons_width>` is smaller.
  294. .. rst-class:: classref-item-separator
  295. ----
  296. .. _class_SpinBox_theme_icon_down:
  297. .. rst-class:: classref-themeproperty
  298. :ref:`Texture2D<class_Texture2D>` **down** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_down>`
  299. Down button icon, displayed in the middle of the down (value-decreasing) button.
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_SpinBox_theme_icon_down_disabled:
  303. .. rst-class:: classref-themeproperty
  304. :ref:`Texture2D<class_Texture2D>` **down_disabled** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_down_disabled>`
  305. Down button icon when the button is disabled.
  306. .. rst-class:: classref-item-separator
  307. ----
  308. .. _class_SpinBox_theme_icon_down_hover:
  309. .. rst-class:: classref-themeproperty
  310. :ref:`Texture2D<class_Texture2D>` **down_hover** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_down_hover>`
  311. Down button icon when the button is hovered.
  312. .. rst-class:: classref-item-separator
  313. ----
  314. .. _class_SpinBox_theme_icon_down_pressed:
  315. .. rst-class:: classref-themeproperty
  316. :ref:`Texture2D<class_Texture2D>` **down_pressed** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_down_pressed>`
  317. Down button icon when the button is being pressed.
  318. .. rst-class:: classref-item-separator
  319. ----
  320. .. _class_SpinBox_theme_icon_up:
  321. .. rst-class:: classref-themeproperty
  322. :ref:`Texture2D<class_Texture2D>` **up** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_up>`
  323. Up button icon, displayed in the middle of the up (value-increasing) button.
  324. .. rst-class:: classref-item-separator
  325. ----
  326. .. _class_SpinBox_theme_icon_up_disabled:
  327. .. rst-class:: classref-themeproperty
  328. :ref:`Texture2D<class_Texture2D>` **up_disabled** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_up_disabled>`
  329. Up button icon when the button is disabled.
  330. .. rst-class:: classref-item-separator
  331. ----
  332. .. _class_SpinBox_theme_icon_up_hover:
  333. .. rst-class:: classref-themeproperty
  334. :ref:`Texture2D<class_Texture2D>` **up_hover** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_up_hover>`
  335. Up button icon when the button is hovered.
  336. .. rst-class:: classref-item-separator
  337. ----
  338. .. _class_SpinBox_theme_icon_up_pressed:
  339. .. rst-class:: classref-themeproperty
  340. :ref:`Texture2D<class_Texture2D>` **up_pressed** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_up_pressed>`
  341. Up button icon when the button is being pressed.
  342. .. rst-class:: classref-item-separator
  343. ----
  344. .. _class_SpinBox_theme_icon_updown:
  345. .. rst-class:: classref-themeproperty
  346. :ref:`Texture2D<class_Texture2D>` **updown** :ref:`๐Ÿ”—<class_SpinBox_theme_icon_updown>`
  347. 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. It is recommended to use individual :ref:`up<class_SpinBox_theme_icon_up>` and :ref:`down<class_SpinBox_theme_icon_down>` graphics for better usability. This can also be used as additional decoration between the two buttons.
  348. .. rst-class:: classref-item-separator
  349. ----
  350. .. _class_SpinBox_theme_style_down_background:
  351. .. rst-class:: classref-themeproperty
  352. :ref:`StyleBox<class_StyleBox>` **down_background** :ref:`๐Ÿ”—<class_SpinBox_theme_style_down_background>`
  353. Background style of the down button.
  354. .. rst-class:: classref-item-separator
  355. ----
  356. .. _class_SpinBox_theme_style_down_background_disabled:
  357. .. rst-class:: classref-themeproperty
  358. :ref:`StyleBox<class_StyleBox>` **down_background_disabled** :ref:`๐Ÿ”—<class_SpinBox_theme_style_down_background_disabled>`
  359. Background style of the down button when disabled.
  360. .. rst-class:: classref-item-separator
  361. ----
  362. .. _class_SpinBox_theme_style_down_background_hovered:
  363. .. rst-class:: classref-themeproperty
  364. :ref:`StyleBox<class_StyleBox>` **down_background_hovered** :ref:`๐Ÿ”—<class_SpinBox_theme_style_down_background_hovered>`
  365. Background style of the down button when hovered.
  366. .. rst-class:: classref-item-separator
  367. ----
  368. .. _class_SpinBox_theme_style_down_background_pressed:
  369. .. rst-class:: classref-themeproperty
  370. :ref:`StyleBox<class_StyleBox>` **down_background_pressed** :ref:`๐Ÿ”—<class_SpinBox_theme_style_down_background_pressed>`
  371. Background style of the down button when being pressed.
  372. .. rst-class:: classref-item-separator
  373. ----
  374. .. _class_SpinBox_theme_style_field_and_buttons_separator:
  375. .. rst-class:: classref-themeproperty
  376. :ref:`StyleBox<class_StyleBox>` **field_and_buttons_separator** :ref:`๐Ÿ”—<class_SpinBox_theme_style_field_and_buttons_separator>`
  377. :ref:`StyleBox<class_StyleBox>` drawn in the space occupied by the separation between the input field and the buttons.
  378. .. rst-class:: classref-item-separator
  379. ----
  380. .. _class_SpinBox_theme_style_up_background:
  381. .. rst-class:: classref-themeproperty
  382. :ref:`StyleBox<class_StyleBox>` **up_background** :ref:`๐Ÿ”—<class_SpinBox_theme_style_up_background>`
  383. Background style of the up button.
  384. .. rst-class:: classref-item-separator
  385. ----
  386. .. _class_SpinBox_theme_style_up_background_disabled:
  387. .. rst-class:: classref-themeproperty
  388. :ref:`StyleBox<class_StyleBox>` **up_background_disabled** :ref:`๐Ÿ”—<class_SpinBox_theme_style_up_background_disabled>`
  389. Background style of the up button when disabled.
  390. .. rst-class:: classref-item-separator
  391. ----
  392. .. _class_SpinBox_theme_style_up_background_hovered:
  393. .. rst-class:: classref-themeproperty
  394. :ref:`StyleBox<class_StyleBox>` **up_background_hovered** :ref:`๐Ÿ”—<class_SpinBox_theme_style_up_background_hovered>`
  395. Background style of the up button when hovered.
  396. .. rst-class:: classref-item-separator
  397. ----
  398. .. _class_SpinBox_theme_style_up_background_pressed:
  399. .. rst-class:: classref-themeproperty
  400. :ref:`StyleBox<class_StyleBox>` **up_background_pressed** :ref:`๐Ÿ”—<class_SpinBox_theme_style_up_background_pressed>`
  401. Background style of the up button when being pressed.
  402. .. rst-class:: classref-item-separator
  403. ----
  404. .. _class_SpinBox_theme_style_up_down_buttons_separator:
  405. .. rst-class:: classref-themeproperty
  406. :ref:`StyleBox<class_StyleBox>` **up_down_buttons_separator** :ref:`๐Ÿ”—<class_SpinBox_theme_style_up_down_buttons_separator>`
  407. :ref:`StyleBox<class_StyleBox>` drawn in the space occupied by the separation between the up and down buttons.
  408. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  409. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  410. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  411. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  412. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  413. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  414. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  415. .. |void| replace:: :abbr:`void (No return value.)`