TabContainer¶
继承¶
Container
简要描述¶
标签页容器。
描述¶
将活动标签的visible属性设置为值true。
忽略非Control子级。
除非使用set_tab_disabled和set_tab_title隐藏它，否则各个标签始终可见。
要仅隐藏标签页的内容，请将内容嵌套在子控件Control中，以便它接收TabContainer的可见性设置。
成员¶
| 类型 | 属性名 | 默认值 |
|---|---|---|
| int | current_tab | 0 |
| bool | drag_to_rearrange_enabled | false |
| int | tab_align | 1 |
| bool | tabs_visible | true |
| bool | use_hidden_tabs_for_min_size | false |
方法¶
| 返回值类型 | 方法名称 |
|---|---|
| Control | get_current_tab_control() const |
| Popup | get_popup() const |
| int | get_previous_tab() const |
| Control | get_tab_control(idx: int) const |
| int | get_tab_count() const |
| bool | get_tab_disabled(tab_idx: int) const |
| Texture | get_tab_icon(tab_idx: int) const |
| String | get_tab_title(tab_idx: int) const |
| int | get_tabs_rearrange_group() const |
| void | set_popup(popup: Node) |
| void | set_tab_disabled(tab_idx: int, disabled: bool) |
| void | set_tab_icon(tab_idx: int, icon: Texture) |
| void | set_tab_title(tab_idx: int, title: String) |
| void | set_tabs_rearrange_group(group_id: int) |
信号¶
- pre_popup_pressed
单击TabContainer的Popup按钮时发出。
- tab_changed
切换到另一个标签时发出。
- tab_selected
选择标签页时发出，即使它是当前标签页也是如此。
枚举¶
enum TabAlign: - ALIGN_LEFT = 0
将标签向左对齐。
- ALIGN_CENTER = 1
将标签中心对齐。
- ALIGN_RIGHT = 2
将标签向右对齐。
常量¶
成员说明¶
- int current_tab
| Default | 0 |
|---|---|
| setter | set_current_tab(value) |
| getter | get_current_tab |
- bool drag_to_rearrange_enabled
| Default | false |
|---|---|
| setter | set_drag_to_rearrange_enabled(value) |
| getter | get_drag_to_rearrange_enabled |
- int tab_align
| Default | 1 |
|---|---|
| setter | set_tab_align(value) |
| getter | get_tab_align |
- bool tabs_visible
| Default | true |
|---|---|
| setter | set_tabs_visible(value) |
| getter | are_tabs_visible |
- bool
| Default | false |
|---|---|
| setter | set_use_hidden_tabs_for_min_size(value) |
| getter | get_use_hidden_tabs_for_min_size |
方法说明¶
- get_current_tab_control get_current_tab_control() const
返回位于活动标签页索引处的Control子节点。
- get_popup get_popup() const
如果已经使用set_popup设置了一个实例，则返回Popup节点实例。
- get_previous_tab get_previous_tab() const
返回先前活动的标签索引。
- get_tab_control get_tab_control(idx: int) const
返回标签页的指定索引处的Control节点。
- get_tab_count get_tab_count() const
返回标签页的数量。
- get_tab_disabled get_tab_disabled(tab_idx: int) const
如果索引tab_idx处的标签页被禁用，则返回true。
- get_tab_icon get_tab_icon(tab_idx: int) const
返回索引为tab_idx的标签页的Texture，如果没有Texture，则返回null。
- get_tab_title get_tab_title(tab_idx: int) const
返回索引为tab_idx的标签的标题。
- get_tabs_rearrange_group get_tabs_rearrange_group() const
返回TabContainer重排的组ID。
- set_popup set_popup(popup: Node)
如果在Popup节点实例上设置，则会在TabContainer的右上角显示一个弹出菜单图标。
- set_tab_disabled set_tab_disabled(tab_idx: int, disabled: bool)
如果disabled为false，隐藏索引在tab_idx处的标签。
**注意：**标题文本将保留，除非也通过set_tab_title删除。
- set_tab_icon set_tab_icon(tab_idx: int, icon: Texture)
为索引为tab_idx的标签设置图标。
- set_tab_title set_tab_title(tab_idx: int, title: String)
为索引tab_idx的标签设置标题。
- set_tabs_rearrange_group set_tabs_rearrange_group(group_id: int)
定义重新排列的组ID，为每个TabContainer选择相同的值以启用在TabContainer之间的标签页拖动。