class_optionbutton.rst 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the OptionButton.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_OptionButton:
  6. OptionButton
  7. ============
  8. **Inherits:** :ref:`Button<class_Button>` **<** :ref:`BaseButton<class_BaseButton>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. Button control that provides selectable options when pressed.
  10. Description
  11. -----------
  12. OptionButton is a type button that provides a selectable list of items when pressed. The item selected becomes the "current" item and is displayed as the button text.
  13. See also :ref:`BaseButton<class_BaseButton>` which contains common properties and methods associated with this node.
  14. Properties
  15. ----------
  16. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  17. | :ref:`ActionMode<enum_BaseButton_ActionMode>` | action_mode | ``0`` (overrides :ref:`BaseButton<class_BaseButton_property_action_mode>`) |
  18. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  19. | :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | alignment | ``0`` (overrides :ref:`Button<class_Button_property_alignment>`) |
  20. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  21. | :ref:`int<class_int>` | :ref:`item_count<class_OptionButton_property_item_count>` | ``0`` |
  22. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  23. | :ref:`int<class_int>` | :ref:`selected<class_OptionButton_property_selected>` | ``-1`` |
  24. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  25. | :ref:`bool<class_bool>` | toggle_mode | ``true`` (overrides :ref:`BaseButton<class_BaseButton_property_toggle_mode>`) |
  26. +-------------------------------------------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------+
  27. Methods
  28. -------
  29. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | void | :ref:`add_icon_item<class_OptionButton_method_add_icon_item>` **(** :ref:`Texture2D<class_Texture2D>` texture, :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)** |
  31. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. | void | :ref:`add_item<class_OptionButton_method_add_item>` **(** :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)** |
  33. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. | void | :ref:`add_separator<class_OptionButton_method_add_separator>` **(** **)** |
  35. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | void | :ref:`clear<class_OptionButton_method_clear>` **(** **)** |
  37. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`Texture2D<class_Texture2D>` | :ref:`get_item_icon<class_OptionButton_method_get_item_icon>` **(** :ref:`int<class_int>` idx **)** |const| |
  39. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`int<class_int>` | :ref:`get_item_id<class_OptionButton_method_get_item_id>` **(** :ref:`int<class_int>` idx **)** |const| |
  41. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`int<class_int>` | :ref:`get_item_index<class_OptionButton_method_get_item_index>` **(** :ref:`int<class_int>` id **)** |const| |
  43. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Variant<class_Variant>` | :ref:`get_item_metadata<class_OptionButton_method_get_item_metadata>` **(** :ref:`int<class_int>` idx **)** |const| |
  45. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`String<class_String>` | :ref:`get_item_text<class_OptionButton_method_get_item_text>` **(** :ref:`int<class_int>` idx **)** |const| |
  47. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_popup<class_OptionButton_method_get_popup>` **(** **)** |const| |
  49. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`int<class_int>` | :ref:`get_selected_id<class_OptionButton_method_get_selected_id>` **(** **)** |const| |
  51. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`Variant<class_Variant>` | :ref:`get_selected_metadata<class_OptionButton_method_get_selected_metadata>` **(** **)** |const| |
  53. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`bool<class_bool>` | :ref:`is_item_disabled<class_OptionButton_method_is_item_disabled>` **(** :ref:`int<class_int>` idx **)** |const| |
  55. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | void | :ref:`remove_item<class_OptionButton_method_remove_item>` **(** :ref:`int<class_int>` idx **)** |
  57. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | void | :ref:`select<class_OptionButton_method_select>` **(** :ref:`int<class_int>` idx **)** |
  59. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | void | :ref:`set_item_disabled<class_OptionButton_method_set_item_disabled>` **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` disabled **)** |
  61. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | void | :ref:`set_item_icon<class_OptionButton_method_set_item_icon>` **(** :ref:`int<class_int>` idx, :ref:`Texture2D<class_Texture2D>` texture **)** |
  63. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | void | :ref:`set_item_id<class_OptionButton_method_set_item_id>` **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` id **)** |
  65. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | void | :ref:`set_item_metadata<class_OptionButton_method_set_item_metadata>` **(** :ref:`int<class_int>` idx, :ref:`Variant<class_Variant>` metadata **)** |
  67. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | void | :ref:`set_item_text<class_OptionButton_method_set_item_text>` **(** :ref:`int<class_int>` idx, :ref:`String<class_String>` text **)** |
  69. +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. Theme Properties
  71. ----------------
  72. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  73. | :ref:`Color<class_Color>` | :ref:`font_color<class_OptionButton_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  74. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  75. | :ref:`Color<class_Color>` | :ref:`font_disabled_color<class_OptionButton_theme_color_font_disabled_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  76. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  77. | :ref:`Color<class_Color>` | :ref:`font_focus_color<class_OptionButton_theme_color_font_focus_color>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  78. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  79. | :ref:`Color<class_Color>` | :ref:`font_hover_color<class_OptionButton_theme_color_font_hover_color>` | ``Color(0.95, 0.95, 0.95, 1)`` |
  80. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  81. | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_OptionButton_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
  82. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  83. | :ref:`Color<class_Color>` | :ref:`font_pressed_color<class_OptionButton_theme_color_font_pressed_color>` | ``Color(1, 1, 1, 1)`` |
  84. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  85. | :ref:`int<class_int>` | :ref:`arrow_margin<class_OptionButton_theme_constant_arrow_margin>` | ``4`` |
  86. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  87. | :ref:`int<class_int>` | :ref:`hseparation<class_OptionButton_theme_constant_hseparation>` | ``2`` |
  88. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  89. | :ref:`int<class_int>` | :ref:`outline_size<class_OptionButton_theme_constant_outline_size>` | ``0`` |
  90. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  91. | :ref:`Font<class_Font>` | :ref:`font<class_OptionButton_theme_font_font>` | |
  92. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  93. | :ref:`int<class_int>` | :ref:`font_size<class_OptionButton_theme_font_size_font_size>` | |
  94. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  95. | :ref:`Texture2D<class_Texture2D>` | :ref:`arrow<class_OptionButton_theme_icon_arrow>` | |
  96. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  97. | :ref:`StyleBox<class_StyleBox>` | :ref:`disabled<class_OptionButton_theme_style_disabled>` | |
  98. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  99. | :ref:`StyleBox<class_StyleBox>` | :ref:`disabled_mirrored<class_OptionButton_theme_style_disabled_mirrored>` | |
  100. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  101. | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_OptionButton_theme_style_focus>` | |
  102. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  103. | :ref:`StyleBox<class_StyleBox>` | :ref:`hover<class_OptionButton_theme_style_hover>` | |
  104. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  105. | :ref:`StyleBox<class_StyleBox>` | :ref:`hover_mirrored<class_OptionButton_theme_style_hover_mirrored>` | |
  106. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  107. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_OptionButton_theme_style_normal>` | |
  108. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  109. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal_mirrored<class_OptionButton_theme_style_normal_mirrored>` | |
  110. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  111. | :ref:`StyleBox<class_StyleBox>` | :ref:`pressed<class_OptionButton_theme_style_pressed>` | |
  112. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  113. | :ref:`StyleBox<class_StyleBox>` | :ref:`pressed_mirrored<class_OptionButton_theme_style_pressed_mirrored>` | |
  114. +-----------------------------------+--------------------------------------------------------------------------------+-------------------------------------+
  115. Signals
  116. -------
  117. .. _class_OptionButton_signal_item_focused:
  118. - **item_focused** **(** :ref:`int<class_int>` index **)**
  119. Emitted when the user navigates to an item using the ``ui_up`` or ``ui_down`` actions. The index of the item selected is passed as argument.
  120. ----
  121. .. _class_OptionButton_signal_item_selected:
  122. - **item_selected** **(** :ref:`int<class_int>` index **)**
  123. Emitted when the current item has been changed by the user. The index of the item selected is passed as argument.
  124. Property Descriptions
  125. ---------------------
  126. .. _class_OptionButton_property_item_count:
  127. - :ref:`int<class_int>` **item_count**
  128. +-----------+-----------------------+
  129. | *Default* | ``0`` |
  130. +-----------+-----------------------+
  131. | *Setter* | set_item_count(value) |
  132. +-----------+-----------------------+
  133. | *Getter* | get_item_count() |
  134. +-----------+-----------------------+
  135. The number of items to select from.
  136. ----
  137. .. _class_OptionButton_property_selected:
  138. - :ref:`int<class_int>` **selected**
  139. +-----------+----------------+
  140. | *Default* | ``-1`` |
  141. +-----------+----------------+
  142. | *Getter* | get_selected() |
  143. +-----------+----------------+
  144. The index of the currently selected item, or ``-1`` if no item is selected.
  145. Method Descriptions
  146. -------------------
  147. .. _class_OptionButton_method_add_icon_item:
  148. - void **add_icon_item** **(** :ref:`Texture2D<class_Texture2D>` texture, :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)**
  149. Adds an item, with a ``texture`` icon, text ``label`` and (optionally) ``id``. If no ``id`` is passed, the item index will be used as the item's ID. New items are appended at the end.
  150. ----
  151. .. _class_OptionButton_method_add_item:
  152. - void **add_item** **(** :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)**
  153. Adds an item, with text ``label`` and (optionally) ``id``. If no ``id`` is passed, the item index will be used as the item's ID. New items are appended at the end.
  154. ----
  155. .. _class_OptionButton_method_add_separator:
  156. - void **add_separator** **(** **)**
  157. Adds a separator to the list of items. Separators help to group items. Separator also takes up an index and is appended at the end.
  158. ----
  159. .. _class_OptionButton_method_clear:
  160. - void **clear** **(** **)**
  161. Clears all the items in the ``OptionButton``.
  162. ----
  163. .. _class_OptionButton_method_get_item_icon:
  164. - :ref:`Texture2D<class_Texture2D>` **get_item_icon** **(** :ref:`int<class_int>` idx **)** |const|
  165. Returns the icon of the item at index ``idx``.
  166. ----
  167. .. _class_OptionButton_method_get_item_id:
  168. - :ref:`int<class_int>` **get_item_id** **(** :ref:`int<class_int>` idx **)** |const|
  169. Returns the ID of the item at index ``idx``.
  170. ----
  171. .. _class_OptionButton_method_get_item_index:
  172. - :ref:`int<class_int>` **get_item_index** **(** :ref:`int<class_int>` id **)** |const|
  173. Returns the index of the item with the given ``id``.
  174. ----
  175. .. _class_OptionButton_method_get_item_metadata:
  176. - :ref:`Variant<class_Variant>` **get_item_metadata** **(** :ref:`int<class_int>` idx **)** |const|
  177. Retrieves the metadata of an item. Metadata may be any type and can be used to store extra information about an item, such as an external string ID.
  178. ----
  179. .. _class_OptionButton_method_get_item_text:
  180. - :ref:`String<class_String>` **get_item_text** **(** :ref:`int<class_int>` idx **)** |const|
  181. Returns the text of the item at index ``idx``.
  182. ----
  183. .. _class_OptionButton_method_get_popup:
  184. - :ref:`PopupMenu<class_PopupMenu>` **get_popup** **(** **)** |const|
  185. Returns the :ref:`PopupMenu<class_PopupMenu>` contained in this button.
  186. \ **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:`Window.visible<class_Window_property_visible>` property.
  187. ----
  188. .. _class_OptionButton_method_get_selected_id:
  189. - :ref:`int<class_int>` **get_selected_id** **(** **)** |const|
  190. Returns the ID of the selected item, or ``-1`` if no item is selected.
  191. ----
  192. .. _class_OptionButton_method_get_selected_metadata:
  193. - :ref:`Variant<class_Variant>` **get_selected_metadata** **(** **)** |const|
  194. Gets the metadata of the selected item. Metadata for items can be set using :ref:`set_item_metadata<class_OptionButton_method_set_item_metadata>`.
  195. ----
  196. .. _class_OptionButton_method_is_item_disabled:
  197. - :ref:`bool<class_bool>` **is_item_disabled** **(** :ref:`int<class_int>` idx **)** |const|
  198. Returns ``true`` if the item at index ``idx`` is disabled.
  199. ----
  200. .. _class_OptionButton_method_remove_item:
  201. - void **remove_item** **(** :ref:`int<class_int>` idx **)**
  202. Removes the item at index ``idx``.
  203. ----
  204. .. _class_OptionButton_method_select:
  205. - void **select** **(** :ref:`int<class_int>` idx **)**
  206. Selects an item by index and makes it the current item. This will work even if the item is disabled.
  207. Passing ``-1`` as the index deselects any currently selected item.
  208. ----
  209. .. _class_OptionButton_method_set_item_disabled:
  210. - void **set_item_disabled** **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` disabled **)**
  211. Sets whether the item at index ``idx`` is disabled.
  212. Disabled items are drawn differently in the dropdown and are not selectable by the user. If the current selected item is set as disabled, it will remain selected.
  213. ----
  214. .. _class_OptionButton_method_set_item_icon:
  215. - void **set_item_icon** **(** :ref:`int<class_int>` idx, :ref:`Texture2D<class_Texture2D>` texture **)**
  216. Sets the icon of the item at index ``idx``.
  217. ----
  218. .. _class_OptionButton_method_set_item_id:
  219. - void **set_item_id** **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` id **)**
  220. Sets the ID of the item at index ``idx``.
  221. ----
  222. .. _class_OptionButton_method_set_item_metadata:
  223. - void **set_item_metadata** **(** :ref:`int<class_int>` idx, :ref:`Variant<class_Variant>` metadata **)**
  224. Sets the metadata of an item. Metadata may be of any type and can be used to store extra information about an item, such as an external string ID.
  225. ----
  226. .. _class_OptionButton_method_set_item_text:
  227. - void **set_item_text** **(** :ref:`int<class_int>` idx, :ref:`String<class_String>` text **)**
  228. Sets the text of the item at index ``idx``.
  229. Theme Property Descriptions
  230. ---------------------------
  231. .. _class_OptionButton_theme_color_font_color:
  232. - :ref:`Color<class_Color>` **font_color**
  233. +-----------+-----------------------------------+
  234. | *Default* | ``Color(0.875, 0.875, 0.875, 1)`` |
  235. +-----------+-----------------------------------+
  236. Default text :ref:`Color<class_Color>` of the ``OptionButton``.
  237. ----
  238. .. _class_OptionButton_theme_color_font_disabled_color:
  239. - :ref:`Color<class_Color>` **font_disabled_color**
  240. +-----------+-------------------------------------+
  241. | *Default* | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  242. +-----------+-------------------------------------+
  243. Text :ref:`Color<class_Color>` used when the ``OptionButton`` is disabled.
  244. ----
  245. .. _class_OptionButton_theme_color_font_focus_color:
  246. - :ref:`Color<class_Color>` **font_focus_color**
  247. +-----------+--------------------------------+
  248. | *Default* | ``Color(0.95, 0.95, 0.95, 1)`` |
  249. +-----------+--------------------------------+
  250. Text :ref:`Color<class_Color>` used when the ``OptionButton`` is focused. Only replaces the normal text color of the button. Disabled, hovered, and pressed states take precedence over this color.
  251. ----
  252. .. _class_OptionButton_theme_color_font_hover_color:
  253. - :ref:`Color<class_Color>` **font_hover_color**
  254. +-----------+--------------------------------+
  255. | *Default* | ``Color(0.95, 0.95, 0.95, 1)`` |
  256. +-----------+--------------------------------+
  257. Text :ref:`Color<class_Color>` used when the ``OptionButton`` is being hovered.
  258. ----
  259. .. _class_OptionButton_theme_color_font_outline_color:
  260. - :ref:`Color<class_Color>` **font_outline_color**
  261. +-----------+-----------------------+
  262. | *Default* | ``Color(1, 1, 1, 1)`` |
  263. +-----------+-----------------------+
  264. The tint of text outline of the ``OptionButton``.
  265. ----
  266. .. _class_OptionButton_theme_color_font_pressed_color:
  267. - :ref:`Color<class_Color>` **font_pressed_color**
  268. +-----------+-----------------------+
  269. | *Default* | ``Color(1, 1, 1, 1)`` |
  270. +-----------+-----------------------+
  271. Text :ref:`Color<class_Color>` used when the ``OptionButton`` is being pressed.
  272. ----
  273. .. _class_OptionButton_theme_constant_arrow_margin:
  274. - :ref:`int<class_int>` **arrow_margin**
  275. +-----------+-------+
  276. | *Default* | ``4`` |
  277. +-----------+-------+
  278. The horizontal space between the arrow icon and the right edge of the button.
  279. ----
  280. .. _class_OptionButton_theme_constant_hseparation:
  281. - :ref:`int<class_int>` **hseparation**
  282. +-----------+-------+
  283. | *Default* | ``2`` |
  284. +-----------+-------+
  285. The horizontal space between ``OptionButton``'s icon and text.
  286. ----
  287. .. _class_OptionButton_theme_constant_outline_size:
  288. - :ref:`int<class_int>` **outline_size**
  289. +-----------+-------+
  290. | *Default* | ``0`` |
  291. +-----------+-------+
  292. The size of the text outline.
  293. ----
  294. .. _class_OptionButton_theme_font_font:
  295. - :ref:`Font<class_Font>` **font**
  296. :ref:`Font<class_Font>` of the ``OptionButton``'s text.
  297. ----
  298. .. _class_OptionButton_theme_font_size_font_size:
  299. - :ref:`int<class_int>` **font_size**
  300. Font size of the ``OptionButton``'s text.
  301. ----
  302. .. _class_OptionButton_theme_icon_arrow:
  303. - :ref:`Texture2D<class_Texture2D>` **arrow**
  304. The arrow icon to be drawn on the right end of the button.
  305. ----
  306. .. _class_OptionButton_theme_style_disabled:
  307. - :ref:`StyleBox<class_StyleBox>` **disabled**
  308. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is disabled (for left-to-right layouts).
  309. ----
  310. .. _class_OptionButton_theme_style_disabled_mirrored:
  311. - :ref:`StyleBox<class_StyleBox>` **disabled_mirrored**
  312. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is disabled (for right-to-left layouts).
  313. ----
  314. .. _class_OptionButton_theme_style_focus:
  315. - :ref:`StyleBox<class_StyleBox>` **focus**
  316. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is focused. The ``focus`` :ref:`StyleBox<class_StyleBox>` is displayed *over* the base :ref:`StyleBox<class_StyleBox>`, so a partially transparent :ref:`StyleBox<class_StyleBox>` should be used to ensure the base :ref:`StyleBox<class_StyleBox>` remains visible. A :ref:`StyleBox<class_StyleBox>` that represents an outline or an underline works well for this purpose. To disable the focus visual effect, assign a :ref:`StyleBoxEmpty<class_StyleBoxEmpty>` resource. Note that disabling the focus visual effect will harm keyboard/controller navigation usability, so this is not recommended for accessibility reasons.
  317. ----
  318. .. _class_OptionButton_theme_style_hover:
  319. - :ref:`StyleBox<class_StyleBox>` **hover**
  320. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is being hovered (for left-to-right layouts).
  321. ----
  322. .. _class_OptionButton_theme_style_hover_mirrored:
  323. - :ref:`StyleBox<class_StyleBox>` **hover_mirrored**
  324. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is being hovered (for right-to-left layouts).
  325. ----
  326. .. _class_OptionButton_theme_style_normal:
  327. - :ref:`StyleBox<class_StyleBox>` **normal**
  328. Default :ref:`StyleBox<class_StyleBox>` for the ``OptionButton`` (for left-to-right layouts).
  329. ----
  330. .. _class_OptionButton_theme_style_normal_mirrored:
  331. - :ref:`StyleBox<class_StyleBox>` **normal_mirrored**
  332. Default :ref:`StyleBox<class_StyleBox>` for the ``OptionButton`` (for right-to-left layouts).
  333. ----
  334. .. _class_OptionButton_theme_style_pressed:
  335. - :ref:`StyleBox<class_StyleBox>` **pressed**
  336. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is being pressed (for left-to-right layouts).
  337. ----
  338. .. _class_OptionButton_theme_style_pressed_mirrored:
  339. - :ref:`StyleBox<class_StyleBox>` **pressed_mirrored**
  340. :ref:`StyleBox<class_StyleBox>` used when the ``OptionButton`` is being pressed (for right-to-left layouts).
  341. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  342. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  343. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  344. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  345. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  346. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`