godot/doc/classes/TreeItem.xml

617 lines
18 KiB
XML

<?xml version="1.0" encoding="UTF-8" ?>
<class name="TreeItem" inherits="Object" category="Core" version="3.0-beta">
<brief_description>
Control for a single item inside a [Tree].
</brief_description>
<description>
Control for a single item inside a [Tree]. May have child [code]TreeItem[/code]s and be styled as well as contain buttons.
</description>
<tutorials>
</tutorials>
<demos>
</demos>
<methods>
<method name="add_button">
<return type="void">
</return>
<argument index="0" name="column" type="int">
</argument>
<argument index="1" name="button" type="Texture">
</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="&quot;&quot;">
</argument>
<description>
Adds a button with [Texture] [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 [code]get_buton_count()[/code] immediately after this method. Optionally, the button can be [code]disabled[/code] and have a [code]tooltip[/code].
</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="Texture">
</return>
<argument index="0" name="column" type="int">
</argument>
<argument index="1" name="button_idx" type="int">
</argument>
<description>
Returns the [Texture] 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_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. See [code]CELL_MODE_*[/code] constants.
</description>
</method>
<method name="get_children">
<return type="TreeItem">
</return>
<description>
Returns the TreeItem's child items.
</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_minimum_height" qualifiers="const">
<return type="int">
</return>
<description>
Returns the custom minimum height.
</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="Texture">
</return>
<argument index="0" name="column" type="int">
</argument>
<description>
Returns the given column's icon [Texture]. 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_region" qualifiers="const">
<return type="Rect2">
</return>
<argument index="0" name="column" type="int">
</argument>
<description>
Returns the icon [Texture] 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.
</description>
</method>
<method name="get_next_visible">
<return type="TreeItem">
</return>
<description>
Returns the next visible TreeItem in the tree.
</description>
</method>
<method name="get_parent">
<return type="TreeItem">
</return>
<description>
Returns the parent TreeItem.
</description>
</method>
<method name="get_prev">
<return type="TreeItem">
</return>
<description>
Returns the previous TreeItem in the tree.
</description>
</method>
<method name="get_prev_visible">
<return type="TreeItem">
</return>
<description>
Returns the previous visible TreeItem in the tree.
</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_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_collapsed">
<return type="bool">
</return>
<description>
Returns [code]true[/code] if this TreeItem is collapsed.
</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_folding_disabled" qualifiers="const">
<return type="bool">
</return>
<description>
Returns [code]true[/code] if folding is disabled for this TreeItem.
</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 child TreeItem at index [code]index[/code].
</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="Texture">
</argument>
<description>
Sets the given column's button [Texture] at index [code]button_idx[/code] to [code]button[/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 [code]CELL_MODE_*[/code] 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_collapsed">
<return type="void">
</return>
<argument index="0" name="enable" type="bool">
</argument>
<description>
If [code]true[/code] the TreeItem is collapsed.
</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="String">
</argument>
<description>
Sets the given column's custom draw callback to [code]callback[/code] method on [code]object[/code].
</description>
</method>
<method name="set_custom_minimum_height">
<return type="void">
</return>
<argument index="0" name="height" type="int">
</argument>
<description>
Sets the custom minimum height of this TreeItem.
</description>
</method>
<method name="set_disable_folding">
<return type="void">
</return>
<argument index="0" name="disable" type="bool">
</argument>
<description>
If [code]true[/code] folding is disabled for this TreeItem.
</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="Texture">
</argument>
<description>
Sets the given column's icon [Texture].
</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_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_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 [code]ALIGN_*[/code] constants.
</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>
<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_RANGE_EXPRESSION" value="3" enum="TreeCellMode">
Cell contains a range expression.
</constant>
<constant name="CELL_MODE_ICON" value="4" enum="TreeCellMode">
Cell contains an icon.
</constant>
<constant name="CELL_MODE_CUSTOM" value="5" 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>