2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2019-04-01 10:33:56 +00:00
<class name= "TabContainer" inherits= "Container" category= "Core" version= "3.2" >
2017-09-12 20:42:36 +00:00
<brief_description >
Tabbed Container.
</brief_description>
<description >
2017-10-21 04:31:45 +00:00
Sets the active tab's [code]visible[/code] property to the value [code]true[/code]. Sets all other children's to [code]false[/code].
2017-10-22 10:56:11 +00:00
Ignores non-[Control] children.
2017-10-21 04:31:45 +00:00
Individual tabs are always visible unless you use [method set_tab_disabled] and [method set_tab_title] to hide it.
2019-03-29 22:37:35 +00:00
To hide only a tab's content, nest the content inside a child [Control], so it receives the [TabContainer]'s visibility setting instead.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "get_current_tab_control" qualifiers= "const" >
<return type= "Control" >
</return>
<description >
2017-10-22 10:56:11 +00:00
Returns the child [Control] node located at the active tab index.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_popup" qualifiers= "const" >
<return type= "Popup" >
</return>
<description >
2017-10-22 10:56:11 +00:00
Returns the [Popup] node instance if one has been set already with [method set_popup].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_previous_tab" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2017-10-22 10:56:11 +00:00
Returns the previously active tab index.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_tab_control" qualifiers= "const" >
<return type= "Control" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2017-10-22 10:56:11 +00:00
Returns the currently visible tab's [Control] node.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_tab_count" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2017-10-21 04:31:45 +00:00
Returns the number of tabs.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_tab_disabled" qualifiers= "const" >
<return type= "bool" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<description >
2017-10-12 19:29:43 +00:00
Returns [code]true[/code] if the tab at index [code]tab_idx[/code] is disabled.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_tab_icon" qualifiers= "const" >
<return type= "Texture" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<description >
2017-10-12 19:29:43 +00:00
Returns the [Texture] for the tab at index [code]tab_idx[/code] or null if the tab has no [Texture].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_tab_title" qualifiers= "const" >
<return type= "String" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<description >
2017-10-21 04:31:45 +00:00
Returns the title of the tab at index [code]tab_idx[/code]. Tab titles default to the name of the indexed child node, but this can be overridden with [method set_tab_title].
2017-09-12 20:42:36 +00:00
</description>
</method>
2018-04-10 08:12:42 +00:00
<method name= "get_tabs_rearrange_group" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2019-03-29 22:37:35 +00:00
Returns the [TabContainer] rearrange group id.
2018-04-10 08:12:42 +00:00
</description>
</method>
2017-09-12 20:42:36 +00:00
<method name= "set_popup" >
<return type= "void" >
</return>
<argument index= "0" name= "popup" type= "Node" >
</argument>
<description >
2019-03-29 22:37:35 +00:00
If set on a [Popup] node instance, a popup menu icon appears in the top-right corner of the [TabContainer]. Clicking it will expand the [Popup] node.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "set_tab_disabled" >
<return type= "void" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<argument index= "1" name= "disabled" type= "bool" >
</argument>
<description >
2019-04-17 11:42:56 +00:00
If [code]disabled[/code] is [code]false[/code], hides the tab at index [code]tab_idx[/code]. Note that its title text will remain, unless also removed with [method set_tab_title].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "set_tab_icon" >
<return type= "void" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<argument index= "1" name= "icon" type= "Texture" >
</argument>
<description >
2017-10-21 04:31:45 +00:00
Sets an icon for the tab at index [code]tab_idx[/code].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "set_tab_title" >
<return type= "void" >
</return>
<argument index= "0" name= "tab_idx" type= "int" >
</argument>
<argument index= "1" name= "title" type= "String" >
</argument>
<description >
2017-10-21 04:31:45 +00:00
Sets a title for the tab at index [code]tab_idx[/code]. Tab titles default to the name of the indexed child node, but this can be overridden with [method set_tab_title].
2017-09-12 20:42:36 +00:00
</description>
</method>
2018-04-10 08:12:42 +00:00
<method name= "set_tabs_rearrange_group" >
<return type= "void" >
</return>
<argument index= "0" name= "group_id" type= "int" >
</argument>
<description >
2019-03-29 22:37:35 +00:00
Defines rearrange group id, choose for each [TabContainer] the same value to enable tab drag between [TabContainer]. Enable drag with [code]set_drag_to_rearrange_enabled(true)[/code].
2018-04-10 08:12:42 +00:00
</description>
</method>
2017-09-12 20:42:36 +00:00
</methods>
<members >
2017-09-13 06:49:40 +00:00
<member name= "current_tab" type= "int" setter= "set_current_tab" getter= "get_current_tab" >
2017-10-22 10:56:11 +00:00
The current tab index. When set, this index's [Control] node's [code]visible[/code] property is set to [code]true[/code] and all others are set to [code]false[/code].
2017-09-12 20:42:36 +00:00
</member>
2018-04-10 08:12:42 +00:00
<member name= "drag_to_rearrange_enabled" type= "bool" setter= "set_drag_to_rearrange_enabled" getter= "get_drag_to_rearrange_enabled" >
2018-10-14 13:58:06 +00:00
If [code]true[/code], tabs can be rearranged with mouse drag.
2018-04-10 08:12:42 +00:00
</member>
2017-09-13 06:49:40 +00:00
<member name= "tab_align" type= "int" setter= "set_tab_align" getter= "get_tab_align" enum= "TabContainer.TabAlign" >
2017-10-21 04:31:45 +00:00
The alignment of all tabs in the tab container. See the [code]ALIGN_*[/code] constants for details.
2017-09-12 20:42:36 +00:00
</member>
2017-09-13 06:49:40 +00:00
<member name= "tabs_visible" type= "bool" setter= "set_tabs_visible" getter= "are_tabs_visible" >
2018-12-20 12:46:54 +00:00
If [code]true[/code], tabs are visible. If [code]false[/code], tabs' content and titles are hidden. Default value: [code]true[/code].
2017-09-12 20:42:36 +00:00
</member>
</members>
<signals >
<signal name= "pre_popup_pressed" >
<description >
2019-03-29 22:37:35 +00:00
Emitted when the [TabContainer]'s [Popup] button is clicked. See [method set_popup] for details.
2017-09-12 20:42:36 +00:00
</description>
</signal>
<signal name= "tab_changed" >
<argument index= "0" name= "tab" type= "int" >
</argument>
<description >
2017-10-21 04:31:45 +00:00
Emitted when switching to another tab.
2017-09-12 20:42:36 +00:00
</description>
</signal>
<signal name= "tab_selected" >
<argument index= "0" name= "tab" type= "int" >
</argument>
<description >
2017-10-21 04:31:45 +00:00
Emitted when a tab is selected, even if it is the current tab.
2017-09-12 20:42:36 +00:00
</description>
</signal>
</signals>
<constants >
2017-11-24 22:16:30 +00:00
<constant name= "ALIGN_LEFT" value= "0" enum= "TabAlign" >
2018-10-14 13:58:06 +00:00
Align the tabs to the left.
2017-09-15 23:46:14 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "ALIGN_CENTER" value= "1" enum= "TabAlign" >
2018-10-14 13:58:06 +00:00
Align the tabs to the center.
2017-09-15 23:46:14 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "ALIGN_RIGHT" value= "2" enum= "TabAlign" >
2018-10-14 13:58:06 +00:00
Align the tabs to the right.
2017-09-15 23:46:14 +00:00
</constant>
2017-09-12 20:42:36 +00:00
</constants>
<theme_items >
<theme_item name= "decrement" type= "Texture" >
</theme_item>
<theme_item name= "decrement_highlight" type= "Texture" >
</theme_item>
<theme_item name= "font" type= "Font" >
</theme_item>
<theme_item name= "font_color_bg" type= "Color" >
</theme_item>
<theme_item name= "font_color_disabled" type= "Color" >
</theme_item>
<theme_item name= "font_color_fg" type= "Color" >
</theme_item>
<theme_item name= "hseparation" type= "int" >
</theme_item>
<theme_item name= "increment" type= "Texture" >
</theme_item>
<theme_item name= "increment_highlight" type= "Texture" >
</theme_item>
<theme_item name= "label_valign_bg" type= "int" >
</theme_item>
<theme_item name= "label_valign_fg" type= "int" >
</theme_item>
<theme_item name= "menu" type= "Texture" >
</theme_item>
<theme_item name= "menu_highlight" type= "Texture" >
</theme_item>
<theme_item name= "panel" type= "StyleBox" >
</theme_item>
<theme_item name= "side_margin" type= "int" >
</theme_item>
<theme_item name= "tab_bg" type= "StyleBox" >
</theme_item>
2019-02-16 13:40:52 +00:00
<theme_item name= "tab_disabled" type= "StyleBox" >
</theme_item>
2017-09-12 20:42:36 +00:00
<theme_item name= "tab_fg" type= "StyleBox" >
</theme_item>
<theme_item name= "top_margin" type= "int" >
</theme_item>
</theme_items>
</class>