<?xml version="1.0" encoding="UTF-8" ?> <class name="TreeItem" inherits="Object" version="4.0"> <brief_description> Control for a single item inside a [Tree]. </brief_description> <description> Control for a single item inside a [Tree]. May have child [TreeItem]s and be styled as well as contain buttons. You can remove a [TreeItem] by using [method Object.free]. </description> <tutorials> </tutorials> <methods> <method name="add_button"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button" type="Texture2D"> </argument> <argument index="2" name="button_idx" type="int" default="-1"> </argument> <argument index="3" name="disabled" type="bool" default="false"> </argument> <argument index="4" name="tooltip" type="String" default=""""> </argument> <description> Adds a button with [Texture2D] [code]button[/code] at column [code]column[/code]. The [code]button_idx[/code] index is used to identify the button when calling other methods. If not specified, the next available index is used, which may be retrieved by calling [method get_button_count] immediately after this method. Optionally, the button can be [code]disabled[/code] and have a [code]tooltip[/code]. </description> </method> <method name="call_recursive" qualifiers="vararg"> <return type="Variant"> </return> <argument index="0" name="method" type="StringName"> </argument> <description> Calls the [code]method[/code] on the actual TreeItem and its children recursively. Pass parameters as a comma separated list. </description> </method> <method name="clear_custom_bg_color"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <description> Resets the background color for the given column to default. </description> </method> <method name="clear_custom_color"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <description> Resets the color for the given column to default. </description> </method> <method name="deselect"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <description> Deselects the given column. </description> </method> <method name="erase_button"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <description> Removes the button at index [code]button_idx[/code] in column [code]column[/code]. </description> </method> <method name="get_button" qualifiers="const"> <return type="Texture2D"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <description> Returns the [Texture2D] of the button at index [code]button_idx[/code] in column [code]column[/code]. </description> </method> <method name="get_button_count" qualifiers="const"> <return type="int"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the number of buttons in column [code]column[/code]. May be used to get the most recently added button's index, if no index was specified. </description> </method> <method name="get_button_tooltip" qualifiers="const"> <return type="String"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <description> Returns the tooltip string for the button at index [code]button_idx[/code] in column [code]column[/code]. </description> </method> <method name="get_cell_mode" qualifiers="const"> <return type="int" enum="TreeItem.TreeCellMode"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the column's cell mode. </description> </method> <method name="get_children"> <return type="TreeItem"> </return> <description> Returns the TreeItem's first child item or a null object if there is none. </description> </method> <method name="get_custom_bg_color" qualifiers="const"> <return type="Color"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the custom background color of column [code]column[/code]. </description> </method> <method name="get_custom_color" qualifiers="const"> <return type="Color"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the custom color of column [code]column[/code]. </description> </method> <method name="get_expand_right" qualifiers="const"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns [code]true[/code] if [code]expand_right[/code] is set. </description> </method> <method name="get_icon" qualifiers="const"> <return type="Texture2D"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the given column's icon [Texture2D]. Error if no icon is set. </description> </method> <method name="get_icon_max_width" qualifiers="const"> <return type="int"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the column's icon's maximum width. </description> </method> <method name="get_icon_modulate" qualifiers="const"> <return type="Color"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the [Color] modulating the column's icon. </description> </method> <method name="get_icon_region" qualifiers="const"> <return type="Rect2"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the icon [Texture2D] region as [Rect2]. </description> </method> <method name="get_metadata" qualifiers="const"> <return type="Variant"> </return> <argument index="0" name="column" type="int"> </argument> <description> </description> </method> <method name="get_next"> <return type="TreeItem"> </return> <description> Returns the next TreeItem in the tree or a null object if there is none. </description> </method> <method name="get_next_visible"> <return type="TreeItem"> </return> <argument index="0" name="wrap" type="bool" default="false"> </argument> <description> Returns the next visible TreeItem in the tree or a null object if there is none. If [code]wrap[/code] 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 [code]null[/code]. </description> </method> <method name="get_parent"> <return type="TreeItem"> </return> <description> Returns the parent TreeItem or a null object if there is none. </description> </method> <method name="get_prev"> <return type="TreeItem"> </return> <description> Returns the previous TreeItem in the tree or a null object if there is none. </description> </method> <method name="get_prev_visible"> <return type="TreeItem"> </return> <argument index="0" name="wrap" type="bool" default="false"> </argument> <description> Returns the previous visible TreeItem in the tree or a null object if there is none. If [code]wrap[/code] 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 [code]null[/code]. </description> </method> <method name="get_range" qualifiers="const"> <return type="float"> </return> <argument index="0" name="column" type="int"> </argument> <description> </description> </method> <method name="get_range_config"> <return type="Dictionary"> </return> <argument index="0" name="column" type="int"> </argument> <description> </description> </method> <method name="get_suffix" qualifiers="const"> <return type="String"> </return> <argument index="0" name="column" type="int"> </argument> <description> </description> </method> <method name="get_text" qualifiers="const"> <return type="String"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the given column's text. </description> </method> <method name="get_text_align" qualifiers="const"> <return type="int" enum="TreeItem.TextAlign"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the given column's text alignment. </description> </method> <method name="get_tooltip" qualifiers="const"> <return type="String"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns the given column's tooltip. </description> </method> <method name="is_button_disabled" qualifiers="const"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <description> Returns [code]true[/code] if the button at index [code]button_idx[/code] for the given column is disabled. </description> </method> <method name="is_checked" qualifiers="const"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns [code]true[/code] if the given column is checked. </description> </method> <method name="is_custom_set_as_button" qualifiers="const"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> </description> </method> <method name="is_editable"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns [code]true[/code] if column [code]column[/code] is editable. </description> </method> <method name="is_selectable" qualifiers="const"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns [code]true[/code] if column [code]column[/code] is selectable. </description> </method> <method name="is_selected"> <return type="bool"> </return> <argument index="0" name="column" type="int"> </argument> <description> Returns [code]true[/code] if column [code]column[/code] is selected. </description> </method> <method name="move_to_bottom"> <return type="void"> </return> <description> Moves this TreeItem to the bottom in the [Tree] hierarchy. </description> </method> <method name="move_to_top"> <return type="void"> </return> <description> Moves this TreeItem to the top in the [Tree] hierarchy. </description> </method> <method name="remove_child"> <return type="void"> </return> <argument index="0" name="child" type="Object"> </argument> <description> Removes the given child [TreeItem] and all its children from the [Tree]. Note that it doesn't free the item from memory, so it can be reused later. To completely remove a [TreeItem] use [method Object.free]. </description> </method> <method name="select"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <description> Selects the column [code]column[/code]. </description> </method> <method name="set_button"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <argument index="2" name="button" type="Texture2D"> </argument> <description> Sets the given column's button [Texture2D] at index [code]button_idx[/code] to [code]button[/code]. </description> </method> <method name="set_button_disabled"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="button_idx" type="int"> </argument> <argument index="2" name="disabled" type="bool"> </argument> <description> If [code]true[/code], disables the button at index [code]button_idx[/code] in column [code]column[/code]. </description> </method> <method name="set_cell_mode"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="mode" type="int" enum="TreeItem.TreeCellMode"> </argument> <description> Sets the given column's cell mode to [code]mode[/code]. See [enum TreeCellMode] constants. </description> </method> <method name="set_checked"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="checked" type="bool"> </argument> <description> If [code]true[/code], the column [code]column[/code] is checked. </description> </method> <method name="set_custom_as_button"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="enable" type="bool"> </argument> <description> </description> </method> <method name="set_custom_bg_color"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="color" type="Color"> </argument> <argument index="2" name="just_outline" type="bool" default="false"> </argument> <description> Sets the given column's custom background color and whether to just use it as an outline. </description> </method> <method name="set_custom_color"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="color" type="Color"> </argument> <description> Sets the given column's custom color. </description> </method> <method name="set_custom_draw"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="object" type="Object"> </argument> <argument index="2" name="callback" type="StringName"> </argument> <description> Sets the given column's custom draw callback to [code]callback[/code] method on [code]object[/code]. The [code]callback[/code] should accept two arguments: the [TreeItem] that is drawn and its position and size as a [Rect2]. </description> </method> <method name="set_editable"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="enabled" type="bool"> </argument> <description> If [code]true[/code], column [code]column[/code] is editable. </description> </method> <method name="set_expand_right"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="enable" type="bool"> </argument> <description> If [code]true[/code], column [code]column[/code] is expanded to the right. </description> </method> <method name="set_icon"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="texture" type="Texture2D"> </argument> <description> Sets the given column's icon [Texture2D]. </description> </method> <method name="set_icon_max_width"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="width" type="int"> </argument> <description> Sets the given column's icon's maximum width. </description> </method> <method name="set_icon_modulate"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="modulate" type="Color"> </argument> <description> Modulates the given column's icon with [code]modulate[/code]. </description> </method> <method name="set_icon_region"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="region" type="Rect2"> </argument> <description> Sets the given column's icon's texture region. </description> </method> <method name="set_metadata"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="meta" type="Variant"> </argument> <description> </description> </method> <method name="set_range"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="value" type="float"> </argument> <description> </description> </method> <method name="set_range_config"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="min" type="float"> </argument> <argument index="2" name="max" type="float"> </argument> <argument index="3" name="step" type="float"> </argument> <argument index="4" name="expr" type="bool" default="false"> </argument> <description> </description> </method> <method name="set_selectable"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="selectable" type="bool"> </argument> <description> If [code]true[/code], the given column is selectable. </description> </method> <method name="set_suffix"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="text" type="String"> </argument> <description> </description> </method> <method name="set_text"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="text" type="String"> </argument> <description> </description> </method> <method name="set_text_align"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="text_align" type="int" enum="TreeItem.TextAlign"> </argument> <description> Sets the given column's text alignment. See [enum TextAlign] for possible values. </description> </method> <method name="set_tooltip"> <return type="void"> </return> <argument index="0" name="column" type="int"> </argument> <argument index="1" name="tooltip" type="String"> </argument> <description> Sets the given column's tooltip text. </description> </method> </methods> <members> <member name="collapsed" type="bool" setter="set_collapsed" getter="is_collapsed"> If [code]true[/code], the TreeItem is collapsed. </member> <member name="custom_minimum_height" type="int" setter="set_custom_minimum_height" getter="get_custom_minimum_height"> The custom minimum height. </member> <member name="disable_folding" type="bool" setter="set_disable_folding" getter="is_folding_disabled"> If [code]true[/code], folding is disabled for this TreeItem. </member> </members> <constants> <constant name="CELL_MODE_STRING" value="0" enum="TreeCellMode"> Cell contains a string. </constant> <constant name="CELL_MODE_CHECK" value="1" enum="TreeCellMode"> Cell can be checked. </constant> <constant name="CELL_MODE_RANGE" value="2" enum="TreeCellMode"> Cell contains a range. </constant> <constant name="CELL_MODE_ICON" value="3" enum="TreeCellMode"> Cell contains an icon. </constant> <constant name="CELL_MODE_CUSTOM" value="4" enum="TreeCellMode"> </constant> <constant name="ALIGN_LEFT" value="0" enum="TextAlign"> Align text to the left. See [code]set_text_align()[/code]. </constant> <constant name="ALIGN_CENTER" value="1" enum="TextAlign"> Center text. See [code]set_text_align()[/code]. </constant> <constant name="ALIGN_RIGHT" value="2" enum="TextAlign"> Align text to the right. See [code]set_text_align()[/code]. </constant> </constants> </class>