TreeItem

Inherits: Object

Control for a single item inside a Tree.

Description

Control for a single item inside a Tree. May have child TreeItems and be styled as well as contain buttons.

You can remove a TreeItem by using Object.free.

Properties

bool

collapsed

int

custom_minimum_height

bool

disable_folding

Methods

void

add_button ( int column, Texture2D button, int id=-1, bool disabled=false, String tooltip="" )

Variant

call_recursive ( StringName method, ... ) vararg

void

clear_custom_bg_color ( int column )

void

clear_custom_color ( int column )

void

clear_opentype_features ( int column )

TreeItem

create_child ( int idx=-1 )

void

deselect ( int column )

void

erase_button ( int column, int button_idx )

Texture2D

get_button ( int column, int button_idx ) const

int

get_button_by_id ( int column, int id ) const

int

get_button_count ( int column ) const

int

get_button_id ( int column, int button_idx ) const

String

get_button_tooltip ( int column, int button_idx ) const

TreeCellMode

get_cell_mode ( int column ) const

TreeItem

get_child ( int idx )

int

get_child_count ( )

Array

get_children ( )

Color

get_custom_bg_color ( int column ) const

Color

get_custom_color ( int column ) const

Font

get_custom_font ( int column ) const

int

get_custom_font_size ( int column ) const

bool

get_expand_right ( int column ) const

TreeItem

get_first_child ( ) const

Texture2D

get_icon ( int column ) const

int

get_icon_max_width ( int column ) const

Color

get_icon_modulate ( int column ) const

Rect2

get_icon_region ( int column ) const

int

get_index ( )

String

get_language ( int column ) const

Variant

get_metadata ( int column ) const

TreeItem

get_next ( ) const

TreeItem

get_next_visible ( bool wrap=false )

int

get_opentype_feature ( int column, String tag ) const

TreeItem

get_parent ( ) const

TreeItem

get_prev ( )

TreeItem

get_prev_visible ( bool wrap=false )

float

get_range ( int column ) const

Dictionary

get_range_config ( int column )

StructuredTextParser

get_structured_text_bidi_override ( int column ) const

Array

get_structured_text_bidi_override_options ( int column ) const

String

get_suffix ( int column ) const

String

get_text ( int column ) const

HorizontalAlignment

get_text_alignment ( int column ) const

TextDirection

get_text_direction ( int column ) const

String

get_tooltip ( int column ) const

Tree

get_tree ( ) const

bool

is_button_disabled ( int column, int button_idx ) const

bool

is_checked ( int column ) const

bool

is_custom_set_as_button ( int column ) const

bool

is_editable ( int column )

bool

is_indeterminate ( int column ) const

bool

is_selectable ( int column ) const

bool

is_selected ( int column )

void

move_after ( TreeItem item )

void

move_before ( TreeItem item )

void

propagate_check ( int column, bool emit_signal=true )

void

remove_child ( TreeItem child )

void

select ( int column )

void

set_button ( int column, int button_idx, Texture2D button )

void

set_button_disabled ( int column, int button_idx, bool disabled )

void

set_cell_mode ( int column, TreeCellMode mode )

void

set_checked ( int column, bool checked )

void

set_custom_as_button ( int column, bool enable )

void

set_custom_bg_color ( int column, Color color, bool just_outline=false )

void

set_custom_color ( int column, Color color )

void

set_custom_draw ( int column, Object object, StringName callback )

void

set_custom_font ( int column, Font font )

void

set_custom_font_size ( int column, int font_size )

void

set_editable ( int column, bool enabled )

void

set_expand_right ( int column, bool enable )

void

set_icon ( int column, Texture2D texture )

void

set_icon_max_width ( int column, int width )

void

set_icon_modulate ( int column, Color modulate )

void

set_icon_region ( int column, Rect2 region )

void

set_indeterminate ( int column, bool indeterminate )

void

set_language ( int column, String language )

void

set_metadata ( int column, Variant meta )

void

set_opentype_feature ( int column, String tag, int value )

void

set_range ( int column, float value )

void

set_range_config ( int column, float min, float max, float step, bool expr=false )

void

set_selectable ( int column, bool selectable )

void

set_structured_text_bidi_override ( int column, StructuredTextParser parser )

void

set_structured_text_bidi_override_options ( int column, Array args )

void

set_suffix ( int column, String text )

void

set_text ( int column, String text )

void

set_text_alignment ( int column, HorizontalAlignment text_alignment )

void

set_text_direction ( int column, TextDirection direction )

void

set_tooltip ( int column, String tooltip )

void

uncollapse_tree ( )

Enumerations

enum TreeCellMode:

  • CELL_MODE_STRING = 0 --- Cell contains a string.

  • CELL_MODE_CHECK = 1 --- Cell contains a checkbox.

  • CELL_MODE_RANGE = 2 --- Cell contains a range.

  • CELL_MODE_ICON = 3 --- Cell contains an icon.

  • CELL_MODE_CUSTOM = 4

Property Descriptions

Setter

set_collapsed(value)

Getter

is_collapsed()

If true, the TreeItem is collapsed.

  • int custom_minimum_height

Setter

set_custom_minimum_height(value)

Getter

get_custom_minimum_height()

The custom minimum height.

  • bool disable_folding

Setter

set_disable_folding(value)

Getter

is_folding_disabled()

If true, folding is disabled for this TreeItem.

Method Descriptions

Adds a button with Texture2D button at column column. The id is used to identify the button. If not specified, the next available index is used, which may be retrieved by calling get_button_count immediately before this method. Optionally, the button can be disabled and have a tooltip.

Calls the method on the actual TreeItem and its children recursively. Pass parameters as a comma separated list.

  • void clear_custom_bg_color ( int column )

Resets the background color for the given column to default.

  • void clear_custom_color ( int column )

Resets the color for the given column to default.

  • void clear_opentype_features ( int column )

Removes all OpenType features.

Creates an item and adds it as a child.

The new item will be inserted as position idx (the default value -1 means the last position), or it will be the last child if idx is higher than the child count.

  • void deselect ( int column )

Deselects the given column.

  • void erase_button ( int column, int button_idx )

Removes the button at index button_idx in column column.

Returns the Texture2D of the button at index button_idx in column column.

  • int get_button_by_id ( int column, int id ) const

Returns the button index if there is a button with id id in column column, otherwise returns -1.

  • int get_button_count ( int column ) const

Returns the number of buttons in column column.

  • int get_button_id ( int column, int button_idx ) const

Returns the id for the button at index button_idx in column column.

  • String get_button_tooltip ( int column, int button_idx ) const

Returns the tooltip string for the button at index button_idx in column column.

Returns the column's cell mode.

Returns a child item by its index (see get_child_count). This method is often used for iterating all children of an item.

Negative indices access the children from the last one.

  • int get_child_count ( )

Returns the number of child items.

Returns an array of references to the item's children.

  • Color get_custom_bg_color ( int column ) const

Returns the custom background color of column column.

  • Color get_custom_color ( int column ) const

Returns the custom color of column column.

  • Font get_custom_font ( int column ) const

Returns custom font used to draw text in the column column.

  • int get_custom_font_size ( int column ) const

Returns custom font size used to draw text in the column column.

  • bool get_expand_right ( int column ) const

Returns true if expand_right is set.

Returns the TreeItem's first child.

Returns the given column's icon Texture2D. Error if no icon is set.

  • int get_icon_max_width ( int column ) const

Returns the column's icon's maximum width.

  • Color get_icon_modulate ( int column ) const

Returns the Color modulating the column's icon.

  • Rect2 get_icon_region ( int column ) const

Returns the icon Texture2D region as Rect2.

  • int get_index ( )

Returns the node's order in the tree. For example, if called on the first child item the position is 0.

Returns item's text language code.

Returns the metadata value that was set for the given column using set_metadata.

Returns the next TreeItem in the tree or a null object if there is none.

Returns the next visible TreeItem in the tree or a null object if there is none.

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.

Returns OpenType feature tag of the item's text.

Returns the parent TreeItem or a null object if there is none.

Returns the previous TreeItem in the tree or a null object if there is none.

Returns the previous visible TreeItem in the tree or a null object if there is none.

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.

Returns the value of a CELL_MODE_RANGE column.

Returns a dictionary containing the range parameters for a given column. The keys are "min", "max", "step", and "expr".

  • Array get_structured_text_bidi_override_options ( int column ) const

Gets the suffix string shown after the column value.

Returns the given column's text.

Returns the given column's text alignment.

Returns item's text base writing direction.

Returns the given column's tooltip.

  • Tree get_tree ( ) const

Returns the Tree that owns this TreeItem.

  • bool is_button_disabled ( int column, int button_idx ) const

Returns true if the button at index button_idx for the given column is disabled.

  • bool is_checked ( int column ) const

Returns true if the given column is checked.

  • bool is_custom_set_as_button ( int column ) const

Returns true if column column is editable.

  • bool is_indeterminate ( int column ) const

Returns true if the given column is indeterminate.

  • bool is_selectable ( int column ) const

Returns true if column column is selectable.

Returns true if column column is selected.

Moves this TreeItem right after the given item.

Note: You can't move to the root or move the root.

Moves this TreeItem right before the given item.

Note: You can't move to the root or move the root.

  • void propagate_check ( int column, bool emit_signal=true )

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 Tree.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 Tree.check_propagated_to_item will not be emitted.

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 Object.free.

  • void select ( int column )

Selects the column column.

Sets the given column's button Texture2D at index button_idx to button.

  • void set_button_disabled ( int column, int button_idx, bool disabled )

If true, disables the button at index button_idx in column column.

Sets the given column's cell mode to mode. See TreeCellMode constants.

  • void set_checked ( int column, bool checked )

If true, the column column is checked. Clears column's indeterminate status.

  • void set_custom_as_button ( int column, bool enable )

  • void set_custom_bg_color ( int column, Color color, bool just_outline=false )

Sets the given column's custom background color and whether to just use it as an outline.

  • void set_custom_color ( int column, Color color )

Sets the given column's custom color.

Sets the given column's custom draw callback to callback method on object.

The callback should accept two arguments: the TreeItem that is drawn and its position and size as a Rect2.

  • void set_custom_font ( int column, Font font )

Sets custom font used to draw text in the column column.

  • void set_custom_font_size ( int column, int font_size )

Sets custom font size used to draw text in the column column.

  • void set_editable ( int column, bool enabled )

If true, column column is editable.

  • void set_expand_right ( int column, bool enable )

If true, column column is expanded to the right.

Sets the given column's icon Texture2D.

  • void set_icon_max_width ( int column, int width )

Sets the given column's icon's maximum width.

  • void set_icon_modulate ( int column, Color modulate )

Modulates the given column's icon with modulate.

  • void set_icon_region ( int column, Rect2 region )

Sets the given column's icon's texture region.

  • void set_indeterminate ( int column, bool indeterminate )

If true, the column column is marked indeterminate.

Note: If set true from false, then column is cleared of checked status.

  • void set_language ( int column, String language )

Sets language code of item's text used for line-breaking and text shaping algorithms, if left empty current locale is used instead.

Sets the metadata value for the given column, which can be retrieved later using get_metadata. This can be used, for example, to store a reference to the original data.

  • void set_opentype_feature ( int column, String tag, int value )

Sets OpenType feature tag for the item's text.

  • void set_range ( int column, float value )

Sets the value of a CELL_MODE_RANGE column.

Sets the range of accepted values for a column. The column must be in the CELL_MODE_RANGE mode.

If expr is true, the edit mode slider will use an exponential scale as with Range.exp_edit.

  • void set_selectable ( int column, bool selectable )

If true, the given column is selectable.

  • void set_structured_text_bidi_override_options ( int column, Array args )

  • void set_suffix ( int column, String text )

Sets a string to be shown after a column's value (for example, a unit abbreviation).

Sets the given column's text value.

Sets the given column's text alignment. See HorizontalAlignment for possible values.

Sets item's text base writing direction.

  • void set_tooltip ( int column, String tooltip )

Sets the given column's tooltip text.

  • void uncollapse_tree ( )