class-description NEWS COMMUNITY STORE TUTORIALS SIGN UP LOGIN LOGOUT ROKOJORI NEWSLETTER SIGN UP LOGIN LOGOUT NEWS COMMUNITY STORE TUTORIALS TOGGLE FULLSCREEN VOLLBILD AN/AUS Object TreeItem
An internal control for a single item inside Tree.

A single item of a Tree control. It can contain other TreeItems as children, which allows it to create a hierarchy. It can also contain text and buttons. TreeItem is not a Node, it is internal to the Tree.

To create a TreeItem, use Tree.create_item() or create_child(). To remove a TreeItem, use Object.free().

 Enum TreeCellMode<>():Enum

CELL_MODE_STRING = 0

Cell shows a string label, optionally with an icon. When editable, the text can be edited using a LineEdit, or a TextEdit popup if set_edit_multiline() is used.


CELL_MODE_CHECK = 1

Cell shows a checkbox, optionally with text and an icon. The checkbox can be pressed, released, or indeterminate (via set_indeterminate()). The checkbox can't be clicked unless the cell is editable.


CELL_MODE_RANGE = 2

Cell shows a numeric range. When editable, it can be edited using a range slider. Use set_range() to set the value and set_range_config() to configure the range.


CELL_MODE_ICON = 3

Cell shows an icon. It can't be edited nor display text. The icon is always centered within the cell.


CELL_MODE_CUSTOM = 4

Cell shows as a clickable button. It will display an arrow similar to OptionButton, but doesn't feature a dropdown (for that you can use CELL_MODE_RANGE). Clicking the button emits the Tree.item_edited signal. The button is flat by default, you can use set_custom_as_button() to display it with a StyleBox.

 bool collapsed<>():bool

If true, the TreeItem is collapsed.

 int custom_minimum_height<>():int

The custom minimum height.

 bool disable_folding<>():bool

If true, folding is disabled for this TreeItem.

 bool visible<>():bool

If true, the TreeItem is visible (default).

Note that if a TreeItem is set to not be visible, none of its children will be visible either.

 void add_button<>( int column=, column:int=, Texture2D button=, button:Texture2D=, int id=-1, id:int=-1, bool disabled=false, disabled:bool=false, String tooltip_text="", tooltip_text:String="", ):void

Adds a button with Texture2D button to the end of the cell at column column. The id is used to identify the button in the according Tree.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 get_button_count() immediately before this method. Optionally, the button can be disabled and have a tooltip_text.

 void add_child<>( TreeItem child=, child:TreeItem=, ):void

Adds a previously unparented TreeItem as a direct child of this one. The child item must not be a part of any Tree or parented to any TreeItem. See also remove_child().

 void call_recursive<>( StringName method=, method:StringName=, ... params=, params:...=, ):void

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

 void clear_buttons<>():void

Removes all buttons from all columns of this item.

 void clear_custom_bg_color<>( int column=, column:int=, ):void

Resets the background color for the given column to default.

 void clear_custom_color<>( int column=, column:int=, ):void

Resets the color for the given column to default.

 TreeItem create_child<>( int index=-1, index:int=-1, ):TreeItem

Creates an item and adds it as a child.

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.

 void deselect<>( int column=, column:int=, ):void

Deselects the given column.

 void erase_button<>( int column=, column:int=, int button_index=, button_index:int=, ):void

Removes the button at index button_index in column column.

 AutoTranslateMode get_auto_translate_mode<>( int column=, column:int=, ):AutoTranslateMode

Returns the column's auto translate mode.

 AutowrapMode get_autowrap_mode<>( int column=, column:int=, ):AutowrapMode

Returns the text autowrap mode in the given column. By default it is TextServer.AUTOWRAP_OFF.

 Texture2D get_button<>( int column=, column:int=, int button_index=, button_index:int=, ):Texture2D

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

 int get_button_by_id<>( int column=, column:int=, int id=, id:int=, ):int

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

 Color get_button_color<>( int column=, column:int=, int id=, id:int=, ):Color

Returns the color of the button with ID id in column column. If the specified button does not exist, returns Color.BLACK.

 int get_button_count<>( int column=, column:int=, ):int

Returns the number of buttons in column column.

 int get_button_id<>( int column=, column:int=, int button_index=, button_index:int=, ):int

Returns the ID for the button at index button_index in column column.

 String get_button_tooltip_text<>( int column=, column:int=, int button_index=, button_index:int=, ):String

Returns the tooltip text for the button at index button_index in column column.

 TreeCellMode get_cell_mode<>( int column=, column:int=, ):TreeCellMode

Returns the column's cell mode.

 TreeItem get_child<>( int index=, index:int=, ):TreeItem

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<>():int

Returns the number of child items.

 Array get_children<>():Array

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

 Color get_custom_bg_color<>( int column=, column:int=, ):Color

Returns the custom background color of column column.

 Color get_custom_color<>( int column=, column:int=, ):Color

Returns the custom color of column column.

 Callable get_custom_draw_callback<>( int column=, column:int=, ):Callable

Returns the custom callback of column column.

 Font get_custom_font<>( int column=, column:int=, ):Font

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

 int get_custom_font_size<>( int column=, column:int=, ):int

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

 bool get_expand_right<>( int column=, column:int=, ):bool

Returns true if expand_right is set.

 TreeItem get_first_child<>():TreeItem

Returns the TreeItem's first child.

 Texture2D get_icon<>( int column=, column:int=, ):Texture2D

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

 int get_icon_max_width<>( int column=, column:int=, ):int

Returns the maximum allowed width of the icon in the given column.

 Color get_icon_modulate<>( int column=, column:int=, ):Color

Returns the Color modulating the column's icon.

 Texture2D get_icon_overlay<>( int column=, column:int=, ):Texture2D

Returns the given column's icon overlay Texture2D.

 Rect2 get_icon_region<>( int column=, column:int=, ):Rect2

Returns the icon Texture2D region as Rect2.

 int get_index<>():int

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

 String get_language<>( int column=, column:int=, ):String

Returns item's text language code.

 Variant get_metadata<>( int column=, column:int=, ):Variant

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

 TreeItem get_next<>():TreeItem

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

 TreeItem get_next_in_tree<>( bool wrap=false, wrap:bool=false, ):TreeItem

Returns the next TreeItem in the tree (in the context of a depth-first search) or a null object if there is none.

If wrap is enabled, the method will wrap around to the first element in the tree when called on the last element, otherwise it returns null.

 TreeItem get_next_visible<>( bool wrap=false, wrap:bool=false, ):TreeItem

Returns the next visible TreeItem in the tree (in the context of a depth-first search) 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.

 TreeItem get_parent<>():TreeItem

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

 TreeItem get_prev<>():TreeItem

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

 TreeItem get_prev_in_tree<>( bool wrap=false, wrap:bool=false, ):TreeItem

Returns the previous TreeItem in the tree (in the context of a depth-first search) or a null object if there is none.

If wrap is enabled, the method will wrap around to the last element in the tree when called on the first visible element, otherwise it returns null.

 TreeItem get_prev_visible<>( bool wrap=false, wrap:bool=false, ):TreeItem

Returns the previous visible sibling TreeItem in the tree (in the context of a depth-first search) 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.

 float get_range<>( int column=, column:int=, ):float

Returns the value of a CELL_MODE_RANGE column.

 Dictionary get_range_config<>( int column=, column:int=, ):Dictionary

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

 StructuredTextParser get_structured_text_bidi_override<>( int column=, column:int=, ):StructuredTextParser

Returns the BiDi algorithm override set for this cell.

 Array get_structured_text_bidi_override_options<>( int column=, column:int=, ):Array

Returns the additional BiDi options set for this cell.

 String get_suffix<>( int column=, column:int=, ):String

Gets the suffix string shown after the column value.

 String get_text<>( int column=, column:int=, ):String

Returns the given column's text.

 HorizontalAlignment get_text_alignment<>( int column=, column:int=, ):HorizontalAlignment

Returns the given column's text alignment.

 TextDirection get_text_direction<>( int column=, column:int=, ):TextDirection

Returns item's text base writing direction.

 OverrunBehavior get_text_overrun_behavior<>( int column=, column:int=, ):OverrunBehavior

Returns the clipping behavior when the text exceeds the item's bounding rectangle in the given column. By default it is TextServer.OVERRUN_TRIM_ELLIPSIS.

 String get_tooltip_text<>( int column=, column:int=, ):String

Returns the given column's tooltip text.

 Tree get_tree<>():Tree

Returns the Tree that owns this TreeItem.

 bool is_any_collapsed<>( bool only_visible=false, only_visible:bool=false, ):bool

Returns true if this TreeItem, or any of its descendants, is collapsed.

If only_visible is true it ignores non-visible TreeItems.

 bool is_button_disabled<>( int column=, column:int=, int button_index=, button_index:int=, ):bool

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

 bool is_checked<>( int column=, column:int=, ):bool

Returns true if the given column is checked.

 bool is_custom_set_as_button<>( int column=, column:int=, ):bool

Returns true if the cell was made into a button with set_custom_as_button().

 bool is_edit_multiline<>( int column=, column:int=, ):bool

Returns true if the given column is multiline editable.

 bool is_editable<>( int column=, column:int=, ):bool

Returns true if the given column is editable.

 bool is_indeterminate<>( int column=, column:int=, ):bool

Returns true if the given column is indeterminate.

 bool is_selectable<>( int column=, column:int=, ):bool

Returns true if the given column is selectable.

 bool is_selected<>( int column=, column:int=, ):bool

Returns true if the given column is selected.

 bool is_visible_in_tree<>():bool

Returns true if visible is true and all its ancestors are also visible.

 void move_after<>( TreeItem item=, item:TreeItem=, ):void

Moves this TreeItem right after the given item.

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

 void move_before<>( TreeItem item=, item:TreeItem=, ):void

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=, column:int=, bool emit_signal=true, emit_signal:bool=true, ):void

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.

 void remove_child<>( TreeItem child=, child:TreeItem=, ):void

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 (see add_child()). To completely remove a TreeItem use Object.free().

Note: If you want to move a child from one Tree to another, then instead of removing and adding it manually you can use move_before() or move_after().

 void select<>( int column=, column:int=, ):void

Selects the given column.

 void set_auto_translate_mode<>( int column=, column:int=, AutoTranslateMode mode=, mode:AutoTranslateMode=, ):void

Sets the given column's auto translate mode to mode.

All columns use Node.AUTO_TRANSLATE_MODE_INHERIT by default, which uses the same auto translate mode as the Tree itself.

 void set_autowrap_mode<>( int column=, column:int=, AutowrapMode autowrap_mode=, autowrap_mode:AutowrapMode=, ):void

Sets the autowrap mode in the given column. If set to something other than TextServer.AUTOWRAP_OFF, the text gets wrapped inside the cell's bounding rectangle.

 void set_button<>( int column=, column:int=, int button_index=, button_index:int=, Texture2D button=, button:Texture2D=, ):void

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

 void set_button_color<>( int column=, column:int=, int button_index=, button_index:int=, Color color=, color:Color=, ):void

Sets the given column's button color at index button_index to color.

 void set_button_disabled<>( int column=, column:int=, int button_index=, button_index:int=, bool disabled=, disabled:bool=, ):void

If true, disables the button at index button_index in the given column.

 void set_button_tooltip_text<>( int column=, column:int=, int button_index=, button_index:int=, String tooltip=, tooltip:String=, ):void

Sets the tooltip text for the button at index button_index in the given column.

 void set_cell_mode<>( int column=, column:int=, TreeCellMode mode=, mode:TreeCellMode=, ):void

Sets the given column's cell mode to mode. This determines how the cell is displayed and edited. See TreeCellMode constants for details.

 void set_checked<>( int column=, column:int=, bool checked=, checked:bool=, ):void

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

 void set_collapsed_recursive<>( bool enable=, enable:bool=, ):void

Collapses or uncollapses this TreeItem and all the descendants of this item.

 void set_custom_as_button<>( int column=, column:int=, bool enable=, enable:bool=, ):void

Makes a cell with CELL_MODE_CUSTOM display as a non-flat button with a StyleBox.

 void set_custom_bg_color<>( int column=, column:int=, Color color=, color:Color=, bool just_outline=false, just_outline:bool=false, ):void

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

 void set_custom_color<>( int column=, column:int=, Color color=, color:Color=, ):void

Sets the given column's custom color.

 void set_custom_draw<>( int column=, column:int=, Object object=, object:Object=, StringName callback=, callback:StringName=, ):void

Deprecated: Use set_custom_draw_callback() instead.

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

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

 void set_custom_draw_callback<>( int column=, column:int=, Callable callback=, callback:Callable=, ):void

Sets the given column's custom draw callback. Use an empty Callable (Callable()) to clear the custom callback. The cell has to be in CELL_MODE_CUSTOM to use this feature.

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=, column:int=, Font font=, font:Font=, ):void

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

 void set_custom_font_size<>( int column=, column:int=, int font_size=, font_size:int=, ):void

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

 void set_edit_multiline<>( int column=, column:int=, bool multiline=, multiline:bool=, ):void

If multiline is true, the given column is multiline editable.

Note: This option only affects the type of control (LineEdit or TextEdit) that appears when editing the column. You can set multiline values with set_text() even if the column is not multiline editable.

 void set_editable<>( int column=, column:int=, bool enabled=, enabled:bool=, ):void

If enabled is true, the given column is editable.

 void set_expand_right<>( int column=, column:int=, bool enable=, enable:bool=, ):void

If enable is true, the given column is expanded to the right.

 void set_icon<>( int column=, column:int=, Texture2D texture=, texture:Texture2D=, ):void

Sets the given cell's icon Texture2D. If the cell is in CELL_MODE_ICON mode, the icon is displayed in the center of the cell. Otherwise, the icon is displayed before the cell's text. CELL_MODE_RANGE does not display an icon.

 void set_icon_max_width<>( int column=, column:int=, int width=, width:int=, ):void

Sets the maximum allowed width of the icon in the given column. This limit is applied on top of the default size of the icon and on top of Tree.icon_max_width. The height is adjusted according to the icon's ratio.

 void set_icon_modulate<>( int column=, column:int=, Color modulate=, modulate:Color=, ):void

Modulates the given column's icon with modulate.

 void set_icon_overlay<>( int column=, column:int=, Texture2D texture=, texture:Texture2D=, ):void

Sets the given cell's icon overlay Texture2D. The cell has to be in CELL_MODE_ICON mode, and icon has to be set. Overlay is drawn on top of icon, in the bottom left corner.

 void set_icon_region<>( int column=, column:int=, Rect2 region=, region:Rect2=, ):void

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

 void set_indeterminate<>( int column=, column:int=, bool indeterminate=, indeterminate:bool=, ):void

If indeterminate is true, the given column is marked indeterminate.

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

 void set_language<>( int column=, column:int=, String language=, language:String=, ):void

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

 void set_metadata<>( int column=, column:int=, Variant meta=, meta:Variant=, ):void

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_range<>( int column=, column:int=, float value=, value:float=, ):void

Sets the value of a CELL_MODE_RANGE column.

 void set_range_config<>( int column=, column:int=, float min=, min:float=, float max=, max:float=, float step=, step:float=, bool expr=false, expr:bool=false, ):void

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=, column:int=, bool selectable=, selectable:bool=, ):void

If selectable is true, the given column is selectable.

 void set_structured_text_bidi_override<>( int column=, column:int=, StructuredTextParser parser=, parser:StructuredTextParser=, ):void

Set BiDi algorithm override for the structured text. Has effect for cells that display text.

 void set_structured_text_bidi_override_options<>( int column=, column:int=, Array args=, args:Array=, ):void

Set additional options for BiDi override. Has effect for cells that display text.

 void set_suffix<>( int column=, column:int=, String text=, text:String=, ):void

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

 void set_text<>( int column=, column:int=, String text=, text:String=, ):void

Sets the given column's text value.

 void set_text_alignment<>( int column=, column:int=, HorizontalAlignment text_alignment=, text_alignment:HorizontalAlignment=, ):void

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

 void set_text_direction<>( int column=, column:int=, TextDirection direction=, direction:TextDirection=, ):void

Sets item's text base writing direction.

 void set_text_overrun_behavior<>( int column=, column:int=, OverrunBehavior overrun_behavior=, overrun_behavior:OverrunBehavior=, ):void

Sets the clipping behavior when the text exceeds the item's bounding rectangle in the given column.

 void set_tooltip_text<>( int column=, column:int=, String tooltip=, tooltip:String=, ):void

Sets the given column's tooltip text.

 void uncollapse_tree<>():void

Uncollapses all TreeItems necessary to reveal this TreeItem, i.e. all ancestor TreeItems.


All social media brands are registrated trademarks and belong to their respective owners.





CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com We are using cookies on this site. Read more... Wir benutzen Cookies auf dieser Seite. Mehr lesen...