TabContainer
继承
简要描述
标签页容器。
描述
将活动标签的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之间的标签页拖动。