class_treeitem.rst 91 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/TreeItem.xml.
  6. .. _class_TreeItem:
  7. TreeItem
  8. ========
  9. **Inherits:** :ref:`Object<class_Object>`
  10. Control for a single item inside a :ref:`Tree<class_Tree>`.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. Control for a single item inside a :ref:`Tree<class_Tree>`. May have child **TreeItem**\ s and be styled as well as contain buttons.
  15. You can remove a **TreeItem** by using :ref:`Object.free<class_Object_method_free>`.
  16. .. rst-class:: classref-reftable-group
  17. Properties
  18. ----------
  19. .. table::
  20. :widths: auto
  21. +-------------------------+-----------------------------------------------------------------------------+
  22. | :ref:`bool<class_bool>` | :ref:`collapsed<class_TreeItem_property_collapsed>` |
  23. +-------------------------+-----------------------------------------------------------------------------+
  24. | :ref:`int<class_int>` | :ref:`custom_minimum_height<class_TreeItem_property_custom_minimum_height>` |
  25. +-------------------------+-----------------------------------------------------------------------------+
  26. | :ref:`bool<class_bool>` | :ref:`disable_folding<class_TreeItem_property_disable_folding>` |
  27. +-------------------------+-----------------------------------------------------------------------------+
  28. | :ref:`bool<class_bool>` | :ref:`visible<class_TreeItem_property_visible>` |
  29. +-------------------------+-----------------------------------------------------------------------------+
  30. .. rst-class:: classref-reftable-group
  31. Methods
  32. -------
  33. .. table::
  34. :widths: auto
  35. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | void | :ref:`add_button<class_TreeItem_method_add_button>` **(** :ref:`int<class_int>` column, :ref:`Texture2D<class_Texture2D>` button, :ref:`int<class_int>` id=-1, :ref:`bool<class_bool>` disabled=false, :ref:`String<class_String>` tooltip_text="" **)** |
  37. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | void | :ref:`call_recursive<class_TreeItem_method_call_recursive>` **(** :ref:`StringName<class_StringName>` method, ... **)** |vararg| |
  39. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | void | :ref:`clear_custom_bg_color<class_TreeItem_method_clear_custom_bg_color>` **(** :ref:`int<class_int>` column **)** |
  41. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | void | :ref:`clear_custom_color<class_TreeItem_method_clear_custom_color>` **(** :ref:`int<class_int>` column **)** |
  43. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`TreeItem<class_TreeItem>` | :ref:`create_child<class_TreeItem_method_create_child>` **(** :ref:`int<class_int>` index=-1 **)** |
  45. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | void | :ref:`deselect<class_TreeItem_method_deselect>` **(** :ref:`int<class_int>` column **)** |
  47. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | void | :ref:`erase_button<class_TreeItem_method_erase_button>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |
  49. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`Texture2D<class_Texture2D>` | :ref:`get_button<class_TreeItem_method_get_button>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const| |
  51. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`int<class_int>` | :ref:`get_button_by_id<class_TreeItem_method_get_button_by_id>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` id **)** |const| |
  53. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`int<class_int>` | :ref:`get_button_count<class_TreeItem_method_get_button_count>` **(** :ref:`int<class_int>` column **)** |const| |
  55. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`int<class_int>` | :ref:`get_button_id<class_TreeItem_method_get_button_id>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const| |
  57. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`String<class_String>` | :ref:`get_button_tooltip_text<class_TreeItem_method_get_button_tooltip_text>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const| |
  59. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` | :ref:`get_cell_mode<class_TreeItem_method_get_cell_mode>` **(** :ref:`int<class_int>` column **)** |const| |
  61. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_child<class_TreeItem_method_get_child>` **(** :ref:`int<class_int>` index **)** |
  63. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`int<class_int>` | :ref:`get_child_count<class_TreeItem_method_get_child_count>` **(** **)** |
  65. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`TreeItem[]<class_TreeItem>` | :ref:`get_children<class_TreeItem_method_get_children>` **(** **)** |
  67. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`Color<class_Color>` | :ref:`get_custom_bg_color<class_TreeItem_method_get_custom_bg_color>` **(** :ref:`int<class_int>` column **)** |const| |
  69. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`Color<class_Color>` | :ref:`get_custom_color<class_TreeItem_method_get_custom_color>` **(** :ref:`int<class_int>` column **)** |const| |
  71. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | :ref:`Font<class_Font>` | :ref:`get_custom_font<class_TreeItem_method_get_custom_font>` **(** :ref:`int<class_int>` column **)** |const| |
  73. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`int<class_int>` | :ref:`get_custom_font_size<class_TreeItem_method_get_custom_font_size>` **(** :ref:`int<class_int>` column **)** |const| |
  75. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | :ref:`bool<class_bool>` | :ref:`get_expand_right<class_TreeItem_method_get_expand_right>` **(** :ref:`int<class_int>` column **)** |const| |
  77. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_first_child<class_TreeItem_method_get_first_child>` **(** **)** |const| |
  79. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Texture2D<class_Texture2D>` | :ref:`get_icon<class_TreeItem_method_get_icon>` **(** :ref:`int<class_int>` column **)** |const| |
  81. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  82. | :ref:`int<class_int>` | :ref:`get_icon_max_width<class_TreeItem_method_get_icon_max_width>` **(** :ref:`int<class_int>` column **)** |const| |
  83. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Color<class_Color>` | :ref:`get_icon_modulate<class_TreeItem_method_get_icon_modulate>` **(** :ref:`int<class_int>` column **)** |const| |
  85. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Rect2<class_Rect2>` | :ref:`get_icon_region<class_TreeItem_method_get_icon_region>` **(** :ref:`int<class_int>` column **)** |const| |
  87. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | :ref:`int<class_int>` | :ref:`get_index<class_TreeItem_method_get_index>` **(** **)** |
  89. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | :ref:`String<class_String>` | :ref:`get_language<class_TreeItem_method_get_language>` **(** :ref:`int<class_int>` column **)** |const| |
  91. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Variant<class_Variant>` | :ref:`get_metadata<class_TreeItem_method_get_metadata>` **(** :ref:`int<class_int>` column **)** |const| |
  93. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  94. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_next<class_TreeItem_method_get_next>` **(** **)** |const| |
  95. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  96. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_next_visible<class_TreeItem_method_get_next_visible>` **(** :ref:`bool<class_bool>` wrap=false **)** |
  97. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  98. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_parent<class_TreeItem_method_get_parent>` **(** **)** |const| |
  99. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  100. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_prev<class_TreeItem_method_get_prev>` **(** **)** |
  101. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  102. | :ref:`TreeItem<class_TreeItem>` | :ref:`get_prev_visible<class_TreeItem_method_get_prev_visible>` **(** :ref:`bool<class_bool>` wrap=false **)** |
  103. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  104. | :ref:`float<class_float>` | :ref:`get_range<class_TreeItem_method_get_range>` **(** :ref:`int<class_int>` column **)** |const| |
  105. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  106. | :ref:`Dictionary<class_Dictionary>` | :ref:`get_range_config<class_TreeItem_method_get_range_config>` **(** :ref:`int<class_int>` column **)** |
  107. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  108. | :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`get_structured_text_bidi_override<class_TreeItem_method_get_structured_text_bidi_override>` **(** :ref:`int<class_int>` column **)** |const| |
  109. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Array<class_Array>` | :ref:`get_structured_text_bidi_override_options<class_TreeItem_method_get_structured_text_bidi_override_options>` **(** :ref:`int<class_int>` column **)** |const| |
  111. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  112. | :ref:`String<class_String>` | :ref:`get_suffix<class_TreeItem_method_get_suffix>` **(** :ref:`int<class_int>` column **)** |const| |
  113. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  114. | :ref:`String<class_String>` | :ref:`get_text<class_TreeItem_method_get_text>` **(** :ref:`int<class_int>` column **)** |const| |
  115. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  116. | :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`get_text_alignment<class_TreeItem_method_get_text_alignment>` **(** :ref:`int<class_int>` column **)** |const| |
  117. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  118. | :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`get_text_direction<class_TreeItem_method_get_text_direction>` **(** :ref:`int<class_int>` column **)** |const| |
  119. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | :ref:`String<class_String>` | :ref:`get_tooltip_text<class_TreeItem_method_get_tooltip_text>` **(** :ref:`int<class_int>` column **)** |const| |
  121. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | :ref:`Tree<class_Tree>` | :ref:`get_tree<class_TreeItem_method_get_tree>` **(** **)** |const| |
  123. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | :ref:`bool<class_bool>` | :ref:`is_any_collapsed<class_TreeItem_method_is_any_collapsed>` **(** :ref:`bool<class_bool>` only_visible=false **)** |
  125. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | :ref:`bool<class_bool>` | :ref:`is_button_disabled<class_TreeItem_method_is_button_disabled>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const| |
  127. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | :ref:`bool<class_bool>` | :ref:`is_checked<class_TreeItem_method_is_checked>` **(** :ref:`int<class_int>` column **)** |const| |
  129. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | :ref:`bool<class_bool>` | :ref:`is_custom_set_as_button<class_TreeItem_method_is_custom_set_as_button>` **(** :ref:`int<class_int>` column **)** |const| |
  131. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | :ref:`bool<class_bool>` | :ref:`is_editable<class_TreeItem_method_is_editable>` **(** :ref:`int<class_int>` column **)** |
  133. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | :ref:`bool<class_bool>` | :ref:`is_indeterminate<class_TreeItem_method_is_indeterminate>` **(** :ref:`int<class_int>` column **)** |const| |
  135. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | :ref:`bool<class_bool>` | :ref:`is_selectable<class_TreeItem_method_is_selectable>` **(** :ref:`int<class_int>` column **)** |const| |
  137. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | :ref:`bool<class_bool>` | :ref:`is_selected<class_TreeItem_method_is_selected>` **(** :ref:`int<class_int>` column **)** |
  139. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | void | :ref:`move_after<class_TreeItem_method_move_after>` **(** :ref:`TreeItem<class_TreeItem>` item **)** |
  141. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | void | :ref:`move_before<class_TreeItem_method_move_before>` **(** :ref:`TreeItem<class_TreeItem>` item **)** |
  143. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | void | :ref:`propagate_check<class_TreeItem_method_propagate_check>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` emit_signal=true **)** |
  145. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | void | :ref:`remove_child<class_TreeItem_method_remove_child>` **(** :ref:`TreeItem<class_TreeItem>` child **)** |
  147. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | void | :ref:`select<class_TreeItem_method_select>` **(** :ref:`int<class_int>` column **)** |
  149. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | void | :ref:`set_button<class_TreeItem_method_set_button>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`Texture2D<class_Texture2D>` button **)** |
  151. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. | void | :ref:`set_button_color<class_TreeItem_method_set_button_color>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`Color<class_Color>` color **)** |
  153. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  154. | void | :ref:`set_button_disabled<class_TreeItem_method_set_button_disabled>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`bool<class_bool>` disabled **)** |
  155. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  156. | void | :ref:`set_cell_mode<class_TreeItem_method_set_cell_mode>` **(** :ref:`int<class_int>` column, :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` mode **)** |
  157. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  158. | void | :ref:`set_checked<class_TreeItem_method_set_checked>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` checked **)** |
  159. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  160. | void | :ref:`set_collapsed_recursive<class_TreeItem_method_set_collapsed_recursive>` **(** :ref:`bool<class_bool>` enable **)** |
  161. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | void | :ref:`set_custom_as_button<class_TreeItem_method_set_custom_as_button>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enable **)** |
  163. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | void | :ref:`set_custom_bg_color<class_TreeItem_method_set_custom_bg_color>` **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` color, :ref:`bool<class_bool>` just_outline=false **)** |
  165. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | void | :ref:`set_custom_color<class_TreeItem_method_set_custom_color>` **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` color **)** |
  167. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | void | :ref:`set_custom_draw<class_TreeItem_method_set_custom_draw>` **(** :ref:`int<class_int>` column, :ref:`Object<class_Object>` object, :ref:`StringName<class_StringName>` callback **)** |
  169. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | void | :ref:`set_custom_font<class_TreeItem_method_set_custom_font>` **(** :ref:`int<class_int>` column, :ref:`Font<class_Font>` font **)** |
  171. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | void | :ref:`set_custom_font_size<class_TreeItem_method_set_custom_font_size>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` font_size **)** |
  173. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | void | :ref:`set_editable<class_TreeItem_method_set_editable>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enabled **)** |
  175. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | void | :ref:`set_expand_right<class_TreeItem_method_set_expand_right>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enable **)** |
  177. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | void | :ref:`set_icon<class_TreeItem_method_set_icon>` **(** :ref:`int<class_int>` column, :ref:`Texture2D<class_Texture2D>` texture **)** |
  179. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | void | :ref:`set_icon_max_width<class_TreeItem_method_set_icon_max_width>` **(** :ref:`int<class_int>` column, :ref:`int<class_int>` width **)** |
  181. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. | void | :ref:`set_icon_modulate<class_TreeItem_method_set_icon_modulate>` **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` modulate **)** |
  183. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  184. | void | :ref:`set_icon_region<class_TreeItem_method_set_icon_region>` **(** :ref:`int<class_int>` column, :ref:`Rect2<class_Rect2>` region **)** |
  185. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  186. | void | :ref:`set_indeterminate<class_TreeItem_method_set_indeterminate>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` indeterminate **)** |
  187. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  188. | void | :ref:`set_language<class_TreeItem_method_set_language>` **(** :ref:`int<class_int>` column, :ref:`String<class_String>` language **)** |
  189. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  190. | void | :ref:`set_metadata<class_TreeItem_method_set_metadata>` **(** :ref:`int<class_int>` column, :ref:`Variant<class_Variant>` meta **)** |
  191. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  192. | void | :ref:`set_range<class_TreeItem_method_set_range>` **(** :ref:`int<class_int>` column, :ref:`float<class_float>` value **)** |
  193. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  194. | void | :ref:`set_range_config<class_TreeItem_method_set_range_config>` **(** :ref:`int<class_int>` column, :ref:`float<class_float>` min, :ref:`float<class_float>` max, :ref:`float<class_float>` step, :ref:`bool<class_bool>` expr=false **)** |
  195. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  196. | void | :ref:`set_selectable<class_TreeItem_method_set_selectable>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` selectable **)** |
  197. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  198. | void | :ref:`set_structured_text_bidi_override<class_TreeItem_method_set_structured_text_bidi_override>` **(** :ref:`int<class_int>` column, :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` parser **)** |
  199. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  200. | void | :ref:`set_structured_text_bidi_override_options<class_TreeItem_method_set_structured_text_bidi_override_options>` **(** :ref:`int<class_int>` column, :ref:`Array<class_Array>` args **)** |
  201. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  202. | void | :ref:`set_suffix<class_TreeItem_method_set_suffix>` **(** :ref:`int<class_int>` column, :ref:`String<class_String>` text **)** |
  203. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  204. | void | :ref:`set_text<class_TreeItem_method_set_text>` **(** :ref:`int<class_int>` column, :ref:`String<class_String>` text **)** |
  205. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  206. | void | :ref:`set_text_alignment<class_TreeItem_method_set_text_alignment>` **(** :ref:`int<class_int>` column, :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` text_alignment **)** |
  207. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  208. | void | :ref:`set_text_direction<class_TreeItem_method_set_text_direction>` **(** :ref:`int<class_int>` column, :ref:`TextDirection<enum_Control_TextDirection>` direction **)** |
  209. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  210. | void | :ref:`set_tooltip_text<class_TreeItem_method_set_tooltip_text>` **(** :ref:`int<class_int>` column, :ref:`String<class_String>` tooltip **)** |
  211. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  212. | void | :ref:`uncollapse_tree<class_TreeItem_method_uncollapse_tree>` **(** **)** |
  213. +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  214. .. rst-class:: classref-section-separator
  215. ----
  216. .. rst-class:: classref-descriptions-group
  217. Enumerations
  218. ------------
  219. .. _enum_TreeItem_TreeCellMode:
  220. .. rst-class:: classref-enumeration
  221. enum **TreeCellMode**:
  222. .. _class_TreeItem_constant_CELL_MODE_STRING:
  223. .. rst-class:: classref-enumeration-constant
  224. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **CELL_MODE_STRING** = ``0``
  225. Cell contains a string.
  226. .. _class_TreeItem_constant_CELL_MODE_CHECK:
  227. .. rst-class:: classref-enumeration-constant
  228. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **CELL_MODE_CHECK** = ``1``
  229. Cell contains a checkbox.
  230. .. _class_TreeItem_constant_CELL_MODE_RANGE:
  231. .. rst-class:: classref-enumeration-constant
  232. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **CELL_MODE_RANGE** = ``2``
  233. Cell contains a range.
  234. .. _class_TreeItem_constant_CELL_MODE_ICON:
  235. .. rst-class:: classref-enumeration-constant
  236. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **CELL_MODE_ICON** = ``3``
  237. Cell contains an icon.
  238. .. _class_TreeItem_constant_CELL_MODE_CUSTOM:
  239. .. rst-class:: classref-enumeration-constant
  240. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **CELL_MODE_CUSTOM** = ``4``
  241. .. rst-class:: classref-section-separator
  242. ----
  243. .. rst-class:: classref-descriptions-group
  244. Property Descriptions
  245. ---------------------
  246. .. _class_TreeItem_property_collapsed:
  247. .. rst-class:: classref-property
  248. :ref:`bool<class_bool>` **collapsed**
  249. .. rst-class:: classref-property-setget
  250. - void **set_collapsed** **(** :ref:`bool<class_bool>` value **)**
  251. - :ref:`bool<class_bool>` **is_collapsed** **(** **)**
  252. If ``true``, the TreeItem is collapsed.
  253. .. rst-class:: classref-item-separator
  254. ----
  255. .. _class_TreeItem_property_custom_minimum_height:
  256. .. rst-class:: classref-property
  257. :ref:`int<class_int>` **custom_minimum_height**
  258. .. rst-class:: classref-property-setget
  259. - void **set_custom_minimum_height** **(** :ref:`int<class_int>` value **)**
  260. - :ref:`int<class_int>` **get_custom_minimum_height** **(** **)**
  261. The custom minimum height.
  262. .. rst-class:: classref-item-separator
  263. ----
  264. .. _class_TreeItem_property_disable_folding:
  265. .. rst-class:: classref-property
  266. :ref:`bool<class_bool>` **disable_folding**
  267. .. rst-class:: classref-property-setget
  268. - void **set_disable_folding** **(** :ref:`bool<class_bool>` value **)**
  269. - :ref:`bool<class_bool>` **is_folding_disabled** **(** **)**
  270. If ``true``, folding is disabled for this TreeItem.
  271. .. rst-class:: classref-item-separator
  272. ----
  273. .. _class_TreeItem_property_visible:
  274. .. rst-class:: classref-property
  275. :ref:`bool<class_bool>` **visible**
  276. .. rst-class:: classref-property-setget
  277. - void **set_visible** **(** :ref:`bool<class_bool>` value **)**
  278. - :ref:`bool<class_bool>` **is_visible** **(** **)**
  279. If ``true``, the **TreeItem** is visible (default).
  280. Note that if a **TreeItem** is set to not be visible, none of its children will be visible either.
  281. .. rst-class:: classref-section-separator
  282. ----
  283. .. rst-class:: classref-descriptions-group
  284. Method Descriptions
  285. -------------------
  286. .. _class_TreeItem_method_add_button:
  287. .. rst-class:: classref-method
  288. void **add_button** **(** :ref:`int<class_int>` column, :ref:`Texture2D<class_Texture2D>` button, :ref:`int<class_int>` id=-1, :ref:`bool<class_bool>` disabled=false, :ref:`String<class_String>` tooltip_text="" **)**
  289. Adds a button with :ref:`Texture2D<class_Texture2D>` ``button`` at column ``column``. The ``id`` is used to identify the button in the according :ref:`Tree.button_clicked<class_Tree_signal_button_clicked>` signal and can be different from the buttons index. If not specified, the next available index is used, which may be retrieved by calling :ref:`get_button_count<class_TreeItem_method_get_button_count>` immediately before this method. Optionally, the button can be ``disabled`` and have a ``tooltip_text``.
  290. .. rst-class:: classref-item-separator
  291. ----
  292. .. _class_TreeItem_method_call_recursive:
  293. .. rst-class:: classref-method
  294. void **call_recursive** **(** :ref:`StringName<class_StringName>` method, ... **)** |vararg|
  295. Calls the ``method`` on the actual TreeItem and its children recursively. Pass parameters as a comma separated list.
  296. .. rst-class:: classref-item-separator
  297. ----
  298. .. _class_TreeItem_method_clear_custom_bg_color:
  299. .. rst-class:: classref-method
  300. void **clear_custom_bg_color** **(** :ref:`int<class_int>` column **)**
  301. Resets the background color for the given column to default.
  302. .. rst-class:: classref-item-separator
  303. ----
  304. .. _class_TreeItem_method_clear_custom_color:
  305. .. rst-class:: classref-method
  306. void **clear_custom_color** **(** :ref:`int<class_int>` column **)**
  307. Resets the color for the given column to default.
  308. .. rst-class:: classref-item-separator
  309. ----
  310. .. _class_TreeItem_method_create_child:
  311. .. rst-class:: classref-method
  312. :ref:`TreeItem<class_TreeItem>` **create_child** **(** :ref:`int<class_int>` index=-1 **)**
  313. Creates an item and adds it as a child.
  314. The new item will be inserted as position ``index`` (the default value ``-1`` means the last position), or it will be the last child if ``index`` is higher than the child count.
  315. .. rst-class:: classref-item-separator
  316. ----
  317. .. _class_TreeItem_method_deselect:
  318. .. rst-class:: classref-method
  319. void **deselect** **(** :ref:`int<class_int>` column **)**
  320. Deselects the given column.
  321. .. rst-class:: classref-item-separator
  322. ----
  323. .. _class_TreeItem_method_erase_button:
  324. .. rst-class:: classref-method
  325. void **erase_button** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)**
  326. Removes the button at index ``button_index`` in column ``column``.
  327. .. rst-class:: classref-item-separator
  328. ----
  329. .. _class_TreeItem_method_get_button:
  330. .. rst-class:: classref-method
  331. :ref:`Texture2D<class_Texture2D>` **get_button** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const|
  332. Returns the :ref:`Texture2D<class_Texture2D>` of the button at index ``button_index`` in column ``column``.
  333. .. rst-class:: classref-item-separator
  334. ----
  335. .. _class_TreeItem_method_get_button_by_id:
  336. .. rst-class:: classref-method
  337. :ref:`int<class_int>` **get_button_by_id** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` id **)** |const|
  338. Returns the button index if there is a button with ID ``id`` in column ``column``, otherwise returns -1.
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_TreeItem_method_get_button_count:
  342. .. rst-class:: classref-method
  343. :ref:`int<class_int>` **get_button_count** **(** :ref:`int<class_int>` column **)** |const|
  344. Returns the number of buttons in column ``column``.
  345. .. rst-class:: classref-item-separator
  346. ----
  347. .. _class_TreeItem_method_get_button_id:
  348. .. rst-class:: classref-method
  349. :ref:`int<class_int>` **get_button_id** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const|
  350. Returns the ID for the button at index ``button_index`` in column ``column``.
  351. .. rst-class:: classref-item-separator
  352. ----
  353. .. _class_TreeItem_method_get_button_tooltip_text:
  354. .. rst-class:: classref-method
  355. :ref:`String<class_String>` **get_button_tooltip_text** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const|
  356. Returns the tooltip text for the button at index ``button_index`` in column ``column``.
  357. .. rst-class:: classref-item-separator
  358. ----
  359. .. _class_TreeItem_method_get_cell_mode:
  360. .. rst-class:: classref-method
  361. :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` **get_cell_mode** **(** :ref:`int<class_int>` column **)** |const|
  362. Returns the column's cell mode.
  363. .. rst-class:: classref-item-separator
  364. ----
  365. .. _class_TreeItem_method_get_child:
  366. .. rst-class:: classref-method
  367. :ref:`TreeItem<class_TreeItem>` **get_child** **(** :ref:`int<class_int>` index **)**
  368. Returns a child item by its ``index`` (see :ref:`get_child_count<class_TreeItem_method_get_child_count>`). This method is often used for iterating all children of an item.
  369. Negative indices access the children from the last one.
  370. .. rst-class:: classref-item-separator
  371. ----
  372. .. _class_TreeItem_method_get_child_count:
  373. .. rst-class:: classref-method
  374. :ref:`int<class_int>` **get_child_count** **(** **)**
  375. Returns the number of child items.
  376. .. rst-class:: classref-item-separator
  377. ----
  378. .. _class_TreeItem_method_get_children:
  379. .. rst-class:: classref-method
  380. :ref:`TreeItem[]<class_TreeItem>` **get_children** **(** **)**
  381. Returns an array of references to the item's children.
  382. .. rst-class:: classref-item-separator
  383. ----
  384. .. _class_TreeItem_method_get_custom_bg_color:
  385. .. rst-class:: classref-method
  386. :ref:`Color<class_Color>` **get_custom_bg_color** **(** :ref:`int<class_int>` column **)** |const|
  387. Returns the custom background color of column ``column``.
  388. .. rst-class:: classref-item-separator
  389. ----
  390. .. _class_TreeItem_method_get_custom_color:
  391. .. rst-class:: classref-method
  392. :ref:`Color<class_Color>` **get_custom_color** **(** :ref:`int<class_int>` column **)** |const|
  393. Returns the custom color of column ``column``.
  394. .. rst-class:: classref-item-separator
  395. ----
  396. .. _class_TreeItem_method_get_custom_font:
  397. .. rst-class:: classref-method
  398. :ref:`Font<class_Font>` **get_custom_font** **(** :ref:`int<class_int>` column **)** |const|
  399. Returns custom font used to draw text in the column ``column``.
  400. .. rst-class:: classref-item-separator
  401. ----
  402. .. _class_TreeItem_method_get_custom_font_size:
  403. .. rst-class:: classref-method
  404. :ref:`int<class_int>` **get_custom_font_size** **(** :ref:`int<class_int>` column **)** |const|
  405. Returns custom font size used to draw text in the column ``column``.
  406. .. rst-class:: classref-item-separator
  407. ----
  408. .. _class_TreeItem_method_get_expand_right:
  409. .. rst-class:: classref-method
  410. :ref:`bool<class_bool>` **get_expand_right** **(** :ref:`int<class_int>` column **)** |const|
  411. Returns ``true`` if ``expand_right`` is set.
  412. .. rst-class:: classref-item-separator
  413. ----
  414. .. _class_TreeItem_method_get_first_child:
  415. .. rst-class:: classref-method
  416. :ref:`TreeItem<class_TreeItem>` **get_first_child** **(** **)** |const|
  417. Returns the TreeItem's first child.
  418. .. rst-class:: classref-item-separator
  419. ----
  420. .. _class_TreeItem_method_get_icon:
  421. .. rst-class:: classref-method
  422. :ref:`Texture2D<class_Texture2D>` **get_icon** **(** :ref:`int<class_int>` column **)** |const|
  423. Returns the given column's icon :ref:`Texture2D<class_Texture2D>`. Error if no icon is set.
  424. .. rst-class:: classref-item-separator
  425. ----
  426. .. _class_TreeItem_method_get_icon_max_width:
  427. .. rst-class:: classref-method
  428. :ref:`int<class_int>` **get_icon_max_width** **(** :ref:`int<class_int>` column **)** |const|
  429. Returns the column's icon's maximum width.
  430. .. rst-class:: classref-item-separator
  431. ----
  432. .. _class_TreeItem_method_get_icon_modulate:
  433. .. rst-class:: classref-method
  434. :ref:`Color<class_Color>` **get_icon_modulate** **(** :ref:`int<class_int>` column **)** |const|
  435. Returns the :ref:`Color<class_Color>` modulating the column's icon.
  436. .. rst-class:: classref-item-separator
  437. ----
  438. .. _class_TreeItem_method_get_icon_region:
  439. .. rst-class:: classref-method
  440. :ref:`Rect2<class_Rect2>` **get_icon_region** **(** :ref:`int<class_int>` column **)** |const|
  441. Returns the icon :ref:`Texture2D<class_Texture2D>` region as :ref:`Rect2<class_Rect2>`.
  442. .. rst-class:: classref-item-separator
  443. ----
  444. .. _class_TreeItem_method_get_index:
  445. .. rst-class:: classref-method
  446. :ref:`int<class_int>` **get_index** **(** **)**
  447. Returns the node's order in the tree. For example, if called on the first child item the position is ``0``.
  448. .. rst-class:: classref-item-separator
  449. ----
  450. .. _class_TreeItem_method_get_language:
  451. .. rst-class:: classref-method
  452. :ref:`String<class_String>` **get_language** **(** :ref:`int<class_int>` column **)** |const|
  453. Returns item's text language code.
  454. .. rst-class:: classref-item-separator
  455. ----
  456. .. _class_TreeItem_method_get_metadata:
  457. .. rst-class:: classref-method
  458. :ref:`Variant<class_Variant>` **get_metadata** **(** :ref:`int<class_int>` column **)** |const|
  459. Returns the metadata value that was set for the given column using :ref:`set_metadata<class_TreeItem_method_set_metadata>`.
  460. .. rst-class:: classref-item-separator
  461. ----
  462. .. _class_TreeItem_method_get_next:
  463. .. rst-class:: classref-method
  464. :ref:`TreeItem<class_TreeItem>` **get_next** **(** **)** |const|
  465. Returns the next sibling TreeItem in the tree or a null object if there is none.
  466. .. rst-class:: classref-item-separator
  467. ----
  468. .. _class_TreeItem_method_get_next_visible:
  469. .. rst-class:: classref-method
  470. :ref:`TreeItem<class_TreeItem>` **get_next_visible** **(** :ref:`bool<class_bool>` wrap=false **)**
  471. Returns the next visible sibling TreeItem in the tree or a null object if there is none.
  472. If ``wrap`` is enabled, the method will wrap around to the first visible element in the tree when called on the last visible element, otherwise it returns ``null``.
  473. .. rst-class:: classref-item-separator
  474. ----
  475. .. _class_TreeItem_method_get_parent:
  476. .. rst-class:: classref-method
  477. :ref:`TreeItem<class_TreeItem>` **get_parent** **(** **)** |const|
  478. Returns the parent TreeItem or a null object if there is none.
  479. .. rst-class:: classref-item-separator
  480. ----
  481. .. _class_TreeItem_method_get_prev:
  482. .. rst-class:: classref-method
  483. :ref:`TreeItem<class_TreeItem>` **get_prev** **(** **)**
  484. Returns the previous sibling TreeItem in the tree or a null object if there is none.
  485. .. rst-class:: classref-item-separator
  486. ----
  487. .. _class_TreeItem_method_get_prev_visible:
  488. .. rst-class:: classref-method
  489. :ref:`TreeItem<class_TreeItem>` **get_prev_visible** **(** :ref:`bool<class_bool>` wrap=false **)**
  490. Returns the previous visible sibling TreeItem in the tree or a null object if there is none.
  491. If ``wrap`` is enabled, the method will wrap around to the last visible element in the tree when called on the first visible element, otherwise it returns ``null``.
  492. .. rst-class:: classref-item-separator
  493. ----
  494. .. _class_TreeItem_method_get_range:
  495. .. rst-class:: classref-method
  496. :ref:`float<class_float>` **get_range** **(** :ref:`int<class_int>` column **)** |const|
  497. Returns the value of a :ref:`CELL_MODE_RANGE<class_TreeItem_constant_CELL_MODE_RANGE>` column.
  498. .. rst-class:: classref-item-separator
  499. ----
  500. .. _class_TreeItem_method_get_range_config:
  501. .. rst-class:: classref-method
  502. :ref:`Dictionary<class_Dictionary>` **get_range_config** **(** :ref:`int<class_int>` column **)**
  503. Returns a dictionary containing the range parameters for a given column. The keys are "min", "max", "step", and "expr".
  504. .. rst-class:: classref-item-separator
  505. ----
  506. .. _class_TreeItem_method_get_structured_text_bidi_override:
  507. .. rst-class:: classref-method
  508. :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override** **(** :ref:`int<class_int>` column **)** |const|
  509. .. container:: contribute
  510. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  511. .. rst-class:: classref-item-separator
  512. ----
  513. .. _class_TreeItem_method_get_structured_text_bidi_override_options:
  514. .. rst-class:: classref-method
  515. :ref:`Array<class_Array>` **get_structured_text_bidi_override_options** **(** :ref:`int<class_int>` column **)** |const|
  516. .. container:: contribute
  517. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  518. .. rst-class:: classref-item-separator
  519. ----
  520. .. _class_TreeItem_method_get_suffix:
  521. .. rst-class:: classref-method
  522. :ref:`String<class_String>` **get_suffix** **(** :ref:`int<class_int>` column **)** |const|
  523. Gets the suffix string shown after the column value.
  524. .. rst-class:: classref-item-separator
  525. ----
  526. .. _class_TreeItem_method_get_text:
  527. .. rst-class:: classref-method
  528. :ref:`String<class_String>` **get_text** **(** :ref:`int<class_int>` column **)** |const|
  529. Returns the given column's text.
  530. .. rst-class:: classref-item-separator
  531. ----
  532. .. _class_TreeItem_method_get_text_alignment:
  533. .. rst-class:: classref-method
  534. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_text_alignment** **(** :ref:`int<class_int>` column **)** |const|
  535. Returns the given column's text alignment.
  536. .. rst-class:: classref-item-separator
  537. ----
  538. .. _class_TreeItem_method_get_text_direction:
  539. .. rst-class:: classref-method
  540. :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction** **(** :ref:`int<class_int>` column **)** |const|
  541. Returns item's text base writing direction.
  542. .. rst-class:: classref-item-separator
  543. ----
  544. .. _class_TreeItem_method_get_tooltip_text:
  545. .. rst-class:: classref-method
  546. :ref:`String<class_String>` **get_tooltip_text** **(** :ref:`int<class_int>` column **)** |const|
  547. Returns the given column's tooltip text.
  548. .. rst-class:: classref-item-separator
  549. ----
  550. .. _class_TreeItem_method_get_tree:
  551. .. rst-class:: classref-method
  552. :ref:`Tree<class_Tree>` **get_tree** **(** **)** |const|
  553. Returns the :ref:`Tree<class_Tree>` that owns this TreeItem.
  554. .. rst-class:: classref-item-separator
  555. ----
  556. .. _class_TreeItem_method_is_any_collapsed:
  557. .. rst-class:: classref-method
  558. :ref:`bool<class_bool>` **is_any_collapsed** **(** :ref:`bool<class_bool>` only_visible=false **)**
  559. Returns ``true`` if this **TreeItem**, or any of its descendants, is collapsed.
  560. If ``only_visible`` is ``true`` it ignores non-visible **TreeItem**\ s.
  561. .. rst-class:: classref-item-separator
  562. ----
  563. .. _class_TreeItem_method_is_button_disabled:
  564. .. rst-class:: classref-method
  565. :ref:`bool<class_bool>` **is_button_disabled** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index **)** |const|
  566. Returns ``true`` if the button at index ``button_index`` for the given ``column`` is disabled.
  567. .. rst-class:: classref-item-separator
  568. ----
  569. .. _class_TreeItem_method_is_checked:
  570. .. rst-class:: classref-method
  571. :ref:`bool<class_bool>` **is_checked** **(** :ref:`int<class_int>` column **)** |const|
  572. Returns ``true`` if the given ``column`` is checked.
  573. .. rst-class:: classref-item-separator
  574. ----
  575. .. _class_TreeItem_method_is_custom_set_as_button:
  576. .. rst-class:: classref-method
  577. :ref:`bool<class_bool>` **is_custom_set_as_button** **(** :ref:`int<class_int>` column **)** |const|
  578. .. container:: contribute
  579. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  580. .. rst-class:: classref-item-separator
  581. ----
  582. .. _class_TreeItem_method_is_editable:
  583. .. rst-class:: classref-method
  584. :ref:`bool<class_bool>` **is_editable** **(** :ref:`int<class_int>` column **)**
  585. Returns ``true`` if the given ``column`` is editable.
  586. .. rst-class:: classref-item-separator
  587. ----
  588. .. _class_TreeItem_method_is_indeterminate:
  589. .. rst-class:: classref-method
  590. :ref:`bool<class_bool>` **is_indeterminate** **(** :ref:`int<class_int>` column **)** |const|
  591. Returns ``true`` if the given ``column`` is indeterminate.
  592. .. rst-class:: classref-item-separator
  593. ----
  594. .. _class_TreeItem_method_is_selectable:
  595. .. rst-class:: classref-method
  596. :ref:`bool<class_bool>` **is_selectable** **(** :ref:`int<class_int>` column **)** |const|
  597. Returns ``true`` if the given ``column`` is selectable.
  598. .. rst-class:: classref-item-separator
  599. ----
  600. .. _class_TreeItem_method_is_selected:
  601. .. rst-class:: classref-method
  602. :ref:`bool<class_bool>` **is_selected** **(** :ref:`int<class_int>` column **)**
  603. Returns ``true`` if the given ``column`` is selected.
  604. .. rst-class:: classref-item-separator
  605. ----
  606. .. _class_TreeItem_method_move_after:
  607. .. rst-class:: classref-method
  608. void **move_after** **(** :ref:`TreeItem<class_TreeItem>` item **)**
  609. Moves this TreeItem right after the given ``item``.
  610. \ **Note:** You can't move to the root or move the root.
  611. .. rst-class:: classref-item-separator
  612. ----
  613. .. _class_TreeItem_method_move_before:
  614. .. rst-class:: classref-method
  615. void **move_before** **(** :ref:`TreeItem<class_TreeItem>` item **)**
  616. Moves this TreeItem right before the given ``item``.
  617. \ **Note:** You can't move to the root or move the root.
  618. .. rst-class:: classref-item-separator
  619. ----
  620. .. _class_TreeItem_method_propagate_check:
  621. .. rst-class:: classref-method
  622. void **propagate_check** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` emit_signal=true **)**
  623. Propagates this item's checked status to its children and parents for the given ``column``. It is possible to process the items affected by this method call by connecting to :ref:`Tree.check_propagated_to_item<class_Tree_signal_check_propagated_to_item>`. The order that the items affected will be processed is as follows: the item invoking this method, children of that item, and finally parents of that item. If ``emit_signal`` is ``false``, then :ref:`Tree.check_propagated_to_item<class_Tree_signal_check_propagated_to_item>` will not be emitted.
  624. .. rst-class:: classref-item-separator
  625. ----
  626. .. _class_TreeItem_method_remove_child:
  627. .. rst-class:: classref-method
  628. void **remove_child** **(** :ref:`TreeItem<class_TreeItem>` child **)**
  629. Removes the given child **TreeItem** and all its children from the :ref:`Tree<class_Tree>`. Note that it doesn't free the item from memory, so it can be reused later. To completely remove a **TreeItem** use :ref:`Object.free<class_Object_method_free>`.
  630. .. rst-class:: classref-item-separator
  631. ----
  632. .. _class_TreeItem_method_select:
  633. .. rst-class:: classref-method
  634. void **select** **(** :ref:`int<class_int>` column **)**
  635. Selects the given ``column``.
  636. .. rst-class:: classref-item-separator
  637. ----
  638. .. _class_TreeItem_method_set_button:
  639. .. rst-class:: classref-method
  640. void **set_button** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`Texture2D<class_Texture2D>` button **)**
  641. Sets the given column's button :ref:`Texture2D<class_Texture2D>` at index ``button_index`` to ``button``.
  642. .. rst-class:: classref-item-separator
  643. ----
  644. .. _class_TreeItem_method_set_button_color:
  645. .. rst-class:: classref-method
  646. void **set_button_color** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`Color<class_Color>` color **)**
  647. Sets the given column's button color at index ``button_index`` to ``color``.
  648. .. rst-class:: classref-item-separator
  649. ----
  650. .. _class_TreeItem_method_set_button_disabled:
  651. .. rst-class:: classref-method
  652. void **set_button_disabled** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` button_index, :ref:`bool<class_bool>` disabled **)**
  653. If ``true``, disables the button at index ``button_index`` in the given ``column``.
  654. .. rst-class:: classref-item-separator
  655. ----
  656. .. _class_TreeItem_method_set_cell_mode:
  657. .. rst-class:: classref-method
  658. void **set_cell_mode** **(** :ref:`int<class_int>` column, :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` mode **)**
  659. Sets the given column's cell mode to ``mode``. See :ref:`TreeCellMode<enum_TreeItem_TreeCellMode>` constants.
  660. .. rst-class:: classref-item-separator
  661. ----
  662. .. _class_TreeItem_method_set_checked:
  663. .. rst-class:: classref-method
  664. void **set_checked** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` checked **)**
  665. If ``true``, the given ``column`` is checked. Clears column's indeterminate status.
  666. .. rst-class:: classref-item-separator
  667. ----
  668. .. _class_TreeItem_method_set_collapsed_recursive:
  669. .. rst-class:: classref-method
  670. void **set_collapsed_recursive** **(** :ref:`bool<class_bool>` enable **)**
  671. Collapses or uncollapses this **TreeItem** and all the descendants of this item.
  672. .. rst-class:: classref-item-separator
  673. ----
  674. .. _class_TreeItem_method_set_custom_as_button:
  675. .. rst-class:: classref-method
  676. void **set_custom_as_button** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enable **)**
  677. .. container:: contribute
  678. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  679. .. rst-class:: classref-item-separator
  680. ----
  681. .. _class_TreeItem_method_set_custom_bg_color:
  682. .. rst-class:: classref-method
  683. void **set_custom_bg_color** **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` color, :ref:`bool<class_bool>` just_outline=false **)**
  684. Sets the given column's custom background color and whether to just use it as an outline.
  685. .. rst-class:: classref-item-separator
  686. ----
  687. .. _class_TreeItem_method_set_custom_color:
  688. .. rst-class:: classref-method
  689. void **set_custom_color** **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` color **)**
  690. Sets the given column's custom color.
  691. .. rst-class:: classref-item-separator
  692. ----
  693. .. _class_TreeItem_method_set_custom_draw:
  694. .. rst-class:: classref-method
  695. void **set_custom_draw** **(** :ref:`int<class_int>` column, :ref:`Object<class_Object>` object, :ref:`StringName<class_StringName>` callback **)**
  696. Sets the given column's custom draw callback to ``callback`` method on ``object``.
  697. The ``callback`` should accept two arguments: the **TreeItem** that is drawn and its position and size as a :ref:`Rect2<class_Rect2>`.
  698. .. rst-class:: classref-item-separator
  699. ----
  700. .. _class_TreeItem_method_set_custom_font:
  701. .. rst-class:: classref-method
  702. void **set_custom_font** **(** :ref:`int<class_int>` column, :ref:`Font<class_Font>` font **)**
  703. Sets custom font used to draw text in the given ``column``.
  704. .. rst-class:: classref-item-separator
  705. ----
  706. .. _class_TreeItem_method_set_custom_font_size:
  707. .. rst-class:: classref-method
  708. void **set_custom_font_size** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` font_size **)**
  709. Sets custom font size used to draw text in the given ``column``.
  710. .. rst-class:: classref-item-separator
  711. ----
  712. .. _class_TreeItem_method_set_editable:
  713. .. rst-class:: classref-method
  714. void **set_editable** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enabled **)**
  715. If ``true``, the given ``column`` is editable.
  716. .. rst-class:: classref-item-separator
  717. ----
  718. .. _class_TreeItem_method_set_expand_right:
  719. .. rst-class:: classref-method
  720. void **set_expand_right** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` enable **)**
  721. If ``true``, the given ``column`` is expanded to the right.
  722. .. rst-class:: classref-item-separator
  723. ----
  724. .. _class_TreeItem_method_set_icon:
  725. .. rst-class:: classref-method
  726. void **set_icon** **(** :ref:`int<class_int>` column, :ref:`Texture2D<class_Texture2D>` texture **)**
  727. Sets the given column's icon :ref:`Texture2D<class_Texture2D>`.
  728. .. rst-class:: classref-item-separator
  729. ----
  730. .. _class_TreeItem_method_set_icon_max_width:
  731. .. rst-class:: classref-method
  732. void **set_icon_max_width** **(** :ref:`int<class_int>` column, :ref:`int<class_int>` width **)**
  733. Sets the given column's icon's maximum width.
  734. .. rst-class:: classref-item-separator
  735. ----
  736. .. _class_TreeItem_method_set_icon_modulate:
  737. .. rst-class:: classref-method
  738. void **set_icon_modulate** **(** :ref:`int<class_int>` column, :ref:`Color<class_Color>` modulate **)**
  739. Modulates the given column's icon with ``modulate``.
  740. .. rst-class:: classref-item-separator
  741. ----
  742. .. _class_TreeItem_method_set_icon_region:
  743. .. rst-class:: classref-method
  744. void **set_icon_region** **(** :ref:`int<class_int>` column, :ref:`Rect2<class_Rect2>` region **)**
  745. Sets the given column's icon's texture region.
  746. .. rst-class:: classref-item-separator
  747. ----
  748. .. _class_TreeItem_method_set_indeterminate:
  749. .. rst-class:: classref-method
  750. void **set_indeterminate** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` indeterminate **)**
  751. If ``true``, the given ``column`` is marked ``indeterminate``.
  752. \ **Note:** If set ``true`` from ``false``, then column is cleared of checked status.
  753. .. rst-class:: classref-item-separator
  754. ----
  755. .. _class_TreeItem_method_set_language:
  756. .. rst-class:: classref-method
  757. void **set_language** **(** :ref:`int<class_int>` column, :ref:`String<class_String>` language **)**
  758. Sets language code of item's text used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
  759. .. rst-class:: classref-item-separator
  760. ----
  761. .. _class_TreeItem_method_set_metadata:
  762. .. rst-class:: classref-method
  763. void **set_metadata** **(** :ref:`int<class_int>` column, :ref:`Variant<class_Variant>` meta **)**
  764. Sets the metadata value for the given column, which can be retrieved later using :ref:`get_metadata<class_TreeItem_method_get_metadata>`. This can be used, for example, to store a reference to the original data.
  765. .. rst-class:: classref-item-separator
  766. ----
  767. .. _class_TreeItem_method_set_range:
  768. .. rst-class:: classref-method
  769. void **set_range** **(** :ref:`int<class_int>` column, :ref:`float<class_float>` value **)**
  770. Sets the value of a :ref:`CELL_MODE_RANGE<class_TreeItem_constant_CELL_MODE_RANGE>` column.
  771. .. rst-class:: classref-item-separator
  772. ----
  773. .. _class_TreeItem_method_set_range_config:
  774. .. rst-class:: classref-method
  775. void **set_range_config** **(** :ref:`int<class_int>` column, :ref:`float<class_float>` min, :ref:`float<class_float>` max, :ref:`float<class_float>` step, :ref:`bool<class_bool>` expr=false **)**
  776. Sets the range of accepted values for a column. The column must be in the :ref:`CELL_MODE_RANGE<class_TreeItem_constant_CELL_MODE_RANGE>` mode.
  777. If ``expr`` is ``true``, the edit mode slider will use an exponential scale as with :ref:`Range.exp_edit<class_Range_property_exp_edit>`.
  778. .. rst-class:: classref-item-separator
  779. ----
  780. .. _class_TreeItem_method_set_selectable:
  781. .. rst-class:: classref-method
  782. void **set_selectable** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` selectable **)**
  783. If ``true``, the given column is selectable.
  784. .. rst-class:: classref-item-separator
  785. ----
  786. .. _class_TreeItem_method_set_structured_text_bidi_override:
  787. .. rst-class:: classref-method
  788. void **set_structured_text_bidi_override** **(** :ref:`int<class_int>` column, :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` parser **)**
  789. .. container:: contribute
  790. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  791. .. rst-class:: classref-item-separator
  792. ----
  793. .. _class_TreeItem_method_set_structured_text_bidi_override_options:
  794. .. rst-class:: classref-method
  795. void **set_structured_text_bidi_override_options** **(** :ref:`int<class_int>` column, :ref:`Array<class_Array>` args **)**
  796. .. container:: contribute
  797. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  798. .. rst-class:: classref-item-separator
  799. ----
  800. .. _class_TreeItem_method_set_suffix:
  801. .. rst-class:: classref-method
  802. void **set_suffix** **(** :ref:`int<class_int>` column, :ref:`String<class_String>` text **)**
  803. Sets a string to be shown after a column's value (for example, a unit abbreviation).
  804. .. rst-class:: classref-item-separator
  805. ----
  806. .. _class_TreeItem_method_set_text:
  807. .. rst-class:: classref-method
  808. void **set_text** **(** :ref:`int<class_int>` column, :ref:`String<class_String>` text **)**
  809. Sets the given column's text value.
  810. .. rst-class:: classref-item-separator
  811. ----
  812. .. _class_TreeItem_method_set_text_alignment:
  813. .. rst-class:: classref-method
  814. void **set_text_alignment** **(** :ref:`int<class_int>` column, :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` text_alignment **)**
  815. Sets the given column's text alignment. See :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` for possible values.
  816. .. rst-class:: classref-item-separator
  817. ----
  818. .. _class_TreeItem_method_set_text_direction:
  819. .. rst-class:: classref-method
  820. void **set_text_direction** **(** :ref:`int<class_int>` column, :ref:`TextDirection<enum_Control_TextDirection>` direction **)**
  821. Sets item's text base writing direction.
  822. .. rst-class:: classref-item-separator
  823. ----
  824. .. _class_TreeItem_method_set_tooltip_text:
  825. .. rst-class:: classref-method
  826. void **set_tooltip_text** **(** :ref:`int<class_int>` column, :ref:`String<class_String>` tooltip **)**
  827. Sets the given column's tooltip text.
  828. .. rst-class:: classref-item-separator
  829. ----
  830. .. _class_TreeItem_method_uncollapse_tree:
  831. .. rst-class:: classref-method
  832. void **uncollapse_tree** **(** **)**
  833. .. container:: contribute
  834. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  835. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  836. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  837. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  838. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  839. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  840. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`