TabContainer

Успадковує: Container < Control < CanvasItem < Node < Object

Контейнер, який створює вкладку для кожного контролю дитини, відображає тільки активний контроль вкладки.

Опис

Влаштовує контроль дитини в вкладку, створюючи вкладку для кожного. Відповідний контроль за активними вкладками здійснюється видимим, при цьому всі інші дитячі елементи приховані. Неконтрольовані діти.

Примітка: Розмальовка натискних вкладок здійснюється за допомогою цього вузла; TabBar не потрібно.

Посібники

Властивості

bool

all_tabs_in_front

false

bool

clip_tabs

true

int

current_tab

-1

bool

deselect_enabled

false

bool

drag_to_rearrange_enabled

false

AlignmentMode

tab_alignment

0

FocusMode

tab_focus_mode

2

TabPosition

tabs_position

0

int

tabs_rearrange_group

-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

TabBar

get_tab_bar() const

Texture2D

get_tab_button_icon(tab_idx: int) const

Control

get_tab_control(tab_idx: int) const

int

get_tab_count() const

Texture2D

get_tab_icon(tab_idx: int) const

int

get_tab_icon_max_width(tab_idx: int) const

int

get_tab_idx_at_point(point: Vector2) const

int

get_tab_idx_from_control(control: Control) const

Variant

get_tab_metadata(tab_idx: int) const

String

get_tab_title(tab_idx: int) const

String

get_tab_tooltip(tab_idx: int) const

bool

is_tab_disabled(tab_idx: int) const

bool

is_tab_hidden(tab_idx: int) const

bool

select_next_available()

bool

select_previous_available()

void

set_popup(popup: Node)

void

set_tab_button_icon(tab_idx: int, icon: Texture2D)

void

set_tab_disabled(tab_idx: int, disabled: bool)

void

set_tab_hidden(tab_idx: int, hidden: bool)

void

set_tab_icon(tab_idx: int, icon: Texture2D)

void

set_tab_icon_max_width(tab_idx: int, width: int)

void

set_tab_metadata(tab_idx: int, metadata: Variant)

void

set_tab_title(tab_idx: int, title: String)

void

set_tab_tooltip(tab_idx: int, tooltip: String)

Властивості теми

Color

drop_mark_color

Color(1, 1, 1, 1)

Color

font_disabled_color

Color(0.875, 0.875, 0.875, 0.5)

Color

font_hovered_color

Color(0.95, 0.95, 0.95, 1)

Color

font_outline_color

Color(0, 0, 0, 1)

Color

font_selected_color

Color(0.95, 0.95, 0.95, 1)

Color

font_unselected_color

Color(0.7, 0.7, 0.7, 1)

int

icon_max_width

0

int

icon_separation

4

int

outline_size

0

int

side_margin

8

int

tab_separation

0

Font

font

int

font_size

Texture2D

decrement

Texture2D

decrement_highlight

Texture2D

drop_mark

Texture2D

increment

Texture2D

increment_highlight

Texture2D

menu

Texture2D

menu_highlight

StyleBox

panel

StyleBox

tab_disabled

StyleBox

tab_focus

StyleBox

tab_hovered

StyleBox

tab_selected

StyleBox

tab_unselected

StyleBox

tabbar_background

Сигнали

active_tab_rearranged(idx_to: int) 🔗

Викликається, коли активну вкладку перевпорядковують перетягуванням миші. Див. drag_to_rearrange_enabled.

pre_popup_pressed() 🔗

Після натискання кнопки TabContainer натисніть кнопку Popup. Див. set_popup() для деталей.

tab_button_pressed(tab: int) 🔗

Увімкніть, коли користувач натискає на значок кнопки на цій вкладці.

tab_changed(tab: int) 🔗

Випробувано при переході на іншу вкладку.

tab_clicked(tab: int) 🔗

При натисканні вкладки, навіть якщо це поточна вкладка.

tab_hovered(tab: int) 🔗

Увімкніть, коли вкладка передається мишкою.

tab_selected(tab: int) 🔗

Увімкнено, коли вкладка вибрана за допомогою кнопок, спрямованого введення, або скрипта, навіть якщо це поточний вкладок.

Переліки

enum TabPosition: 🔗

TabPosition POSITION_TOP = 0

Помістіть вкладку вгорі.

TabPosition POSITION_BOTTOM = 1

Помістіть вкладку в нижній частині. Вкладка-бар StyleBox буде переповнена вертикально.

TabPosition POSITION_MAX = 2

Представляємо розмір tabPosition enum.

Описи властивостей

bool all_tabs_in_front = false 🔗

  • void set_all_tabs_in_front(value: bool)

  • bool is_all_tabs_in_front()

Якщо true, всі вкладки витягуються перед панеллю. Якщо false, неактивні вкладки витягуються за панеллю.

bool clip_tabs = true 🔗

  • void set_clip_tabs(value: bool)

  • bool get_clip_tabs()

Якщо true, вкладки, що переповнюють ширину цього вузла, будуть приховані, відображають дві кнопки навігації замість. В іншому випадку цей розмір вузла оновлюється таким чином, щоб всі вкладки були видимими.

int current_tab = -1 🔗

  • void set_current_tab(value: int)

  • int get_current_tab()

Індекс поточного вкладки. Коли встановлено, цей індекс Control вершина видких має значення true і всі інші встановлюються до false.

Значення -1 означає, що не вибрано вкладку.

bool deselect_enabled = false 🔗

  • void set_deselect_enabled(value: bool)

  • bool get_deselect_enabled()

Якщо true, всі вкладки можна видалити так, щоб не вибрано вкладку. Натисніть на current_tab, щоб видалити його.

Тільки заголовок вкладки буде показано, якщо не вибрано вкладки.

bool drag_to_rearrange_enabled = false 🔗

  • void set_drag_to_rearrange_enabled(value: bool)

  • bool get_drag_to_rearrange_enabled()

Якщо true, вкладки можна перепланувати з перетягуванням миші.

AlignmentMode tab_alignment = 0 🔗

Позиція, в якій будуть розміщені вкладки.

FocusMode tab_focus_mode = 2 🔗

Режим доступу фокусу для внутрішнього вузла TabBar.

TabPosition tabs_position = 0 🔗

Положення панелі вкладок.

int tabs_rearrange_group = -1 🔗

  • void set_tabs_rearrange_group(value: int)

  • int get_tabs_rearrange_group()

TabContainer з тим самим ідентифікатором групи задніх груп дозволить перетягування вкладок між ними. Увімкнути перетягування drag_to_rearrange_enabled.

Налаштування цього до -1 буде відключати перетягування між TabContainers.

bool tabs_visible = true 🔗

  • void set_tabs_visible(value: bool)

  • bool are_tabs_visible()

Якщо true, вкладки видно. Якщо false, вміст вкладок і заголовки приховані.

bool use_hidden_tabs_for_min_size = false 🔗

  • void set_use_hidden_tabs_for_min_size(value: bool)

  • bool get_use_hidden_tabs_for_min_size()

Якщо true, дитина Control вершини, які приховані, мають мінімальний розмір, враховуються в цілому, замість того, що в даний час видно один.

Описи методів

Control get_current_tab_control() const 🔗

Повертаємо дитину Control вершину, розташованого в активному індексі вкладок.

Popup get_popup() const 🔗

Повертаємо вузол Popup, якщо один був встановлений вже з set_popup().

Попередження: Це необхідний внутрішній вузол, видаляючи і звільняючи його може призвести до аварії. Якщо ви хочете приховати його або будь-який з своїх дітей, скористайтеся їх Window.visible.

int get_previous_tab() const 🔗

Повернути індекс раніше активної вкладки.

TabBar get_tab_bar() const 🔗

Повернення TabBar, що міститься в цьому контейнері.

Попередження: Це необхідний внутрішній вузол, видаляючи і звільняючи його або редагування вкладок може призвести до аварії. Якщо ви хочете редагувати вкладки, скористайтеся способами, передбаченими TabContainer.

Texture2D get_tab_button_icon(tab_idx: int) const 🔗

Повертаємо значок кнопки з вкладки в індекс tab_idx.

Control get_tab_control(tab_idx: int) const 🔗

Повертає вузол Control з вкладки в індекс tab_idx.

int get_tab_count() const 🔗

Повертає кількість вкладок.

Texture2D get_tab_icon(tab_idx: int) const 🔗

Повернення Texture2D для вкладки в індекс tab_idx або null, якщо вкладка не має Texture2D.

int get_tab_icon_max_width(tab_idx: int) const 🔗

Повертаємо максимальну допустиму ширину іконки для вкладки в індекс tab_idx.

int get_tab_idx_at_point(point: Vector2) const 🔗

Повернення індексу вкладки в локальні координати пункт абзаців. Повертаємо -1, якщо точка знаходиться поза межами контролю або якщо у вас немає вкладки на переглянуту позицію.

int get_tab_idx_from_control(control: Control) const 🔗

Повертає індекс вкладки, що прив'язується до вказаного control. Контроль повинен бути дитиною TabContainer.

Variant get_tab_metadata(tab_idx: int) const 🔗

Повертає набір значень метаданих до вкладки в індекс tab_idx за допомогою set_tab_metadata(). Якщо раніше не встановлено метадані, повертає null за замовчуванням.

String get_tab_title(tab_idx: int) const 🔗

Повертає назву вкладки в індекс tab_idx. Заголовок вкладки за замовчуванням до назви індексованої дочірньої вершини, але це може бути перейменден з set_tab_title().

String get_tab_tooltip(tab_idx: int) const 🔗

Повертає текст вкладки в індекс tab_idx.

bool is_tab_disabled(tab_idx: int) const 🔗

Повертає true, якщо вкладка в індексі tab_idx вимкнена.

bool is_tab_hidden(tab_idx: int) const 🔗

Повертає true, якщо вкладка в індексі tab_idx прихована.

bool select_next_available() 🔗

Виберіть перший доступний вкладку з більшим індексом, ніж обраний в даний час. Повернення true якщо змінено вибір вкладок.

bool select_previous_available() 🔗

Виберіть перший доступний вкладку з меншим індексом, ніж обраний в даний час. Повертає true, якщо змінено вибір вкладок.

void set_popup(popup: Node) 🔗

Якщо встановити на Popup екземпляр вершини, пікап меню з'являється в верхньому правому куті TabContainer (встановивши його на null, зробіть його відкатно). Клацання він буде розширювати вузол Popup.

void set_tab_button_icon(tab_idx: int, icon: Texture2D) 🔗

Встановлює іконку кнопки з вкладки в індекс tab_idx.

void set_tab_disabled(tab_idx: int, disabled: bool) 🔗

Якщо disabled має значення true, вкладка за індексом tab_idx вимикається, що робить її невзаємодіючою.

void set_tab_hidden(tab_idx: int, hidden: bool) 🔗

Якщо hidden має значення true, приховує вкладку за індексом tab_idx, що зникає з області вкладок.

void set_tab_icon(tab_idx: int, icon: Texture2D) 🔗

Встановіть іконку для вкладки в індекс tab_idx.

void set_tab_icon_max_width(tab_idx: int, width: int) 🔗

Встановлює максимально допустиму ширину значка для вкладки з індексом tab_idx. Це обмеження застосовується поверх стандартного розміру значка та поверх icon_max_width. Висота налаштовується відповідно до співвідношення сторін значка.

void set_tab_metadata(tab_idx: int, metadata: Variant) 🔗

Встановіть значення метаданих для вкладки в індекс tab_idx, який можна отримати пізніше за допомогою get_tab_metadata().

void set_tab_title(tab_idx: int, title: String) 🔗

Встановлює користувацький титул для вкладки в індекс tab_idx (tab titles default to name indexed child node). Встановіть його назад до назви дитини, щоб зробити за замовчуванням вкладки до неї знову.

void set_tab_tooltip(tab_idx: int, tooltip: String) 🔗

Встановлює користувальницький інструмент для вкладки в індекс tab_idx.

Примітка: За замовчуванням, якщо tooltip є порожнім і текст вкладки truncated (не всі символи вписуються в вкладку), назву буде відображатися як інструмент. Щоб приховати прилади, призначте " " як текст tooltip.

Описи тематичної нерухомості

Color drop_mark_color = Color(1, 1, 1, 1) 🔗

Модуляційний колір для іконки drop_mark.

Color font_disabled_color = Color(0.875, 0.875, 0.875, 0.5) 🔗

Колір шрифту відключених вкладок.

Color font_hovered_color = Color(0.95, 0.95, 0.95, 1) 🔗

Колір шрифту в даний час ховається вкладка.

Color font_outline_color = Color(0, 0, 0, 1) 🔗

Вміст текстового контуру імені вкладки.

Color font_selected_color = Color(0.95, 0.95, 0.95, 1) 🔗

Колір шрифту вказаної вкладки.

Color font_unselected_color = Color(0.7, 0.7, 0.7, 1) 🔗

Колір шрифту іншого, невибрані вкладки.

int icon_max_width = 0 🔗

Максимальна допустима ширина іконки вкладки. Цей ліміт наноситься зверху за замовчуванням розмір іконки, але перед значенням, встановленим TabBar.set_tab_icon_max_width(). Висота регульована відповідно до співвідношення ікони.

int icon_separation = 4 🔗

Простір між назвою вкладки та його іконою.

int outline_size = 0 🔗

Розмір тексту вкладки.

Примітка: Якщо за допомогою шрифту FontFile.multiканал_signed_distance_field ввімкнено, його FontFile.msdf_pixel_range необхідно встановити принаймні twice значення index_size для позначення, що дає змогу виглядати правильно. В іншому випадку контур може з'явитися, щоб зрізати раніше, ніж призначений.

int side_margin = 8 🔗

Проміжок на лівому або правому краях панелі вкладок, відповідно до поточного tab_alignment.

Відступ ігнорується з TabBar.ALIGNMENT_RIGHT, якщо вкладки обрізані (див. clip_tabs) або встановлено спливаюче вікно (див. set_popup()). Відступ завжди ігнорується з TabBar.ALIGNMENT_CENTER.

int tab_separation = 0 🔗

Простір між вкладками на панелі вкладок.

Font font 🔗

Шрифт, який використовується для позначення назв вкладок.

int font_size 🔗

Розмір шрифту назв вкладок.

Texture2D decrement 🔗

Ікона для лівої стрілки, яка з'являється, коли є занадто багато вкладок, щоб відповідати в ширину контейнера. Коли кнопка вимкнена (тобто видно першу вкладку), вона з'являється напівпрозорою.

Texture2D decrement_highlight 🔗

Ікона для лівої стрілки, яка з'являється, коли є занадто багато вкладок, щоб відповідати в ширину контейнера. Використовуються при натисканні кнопки з курсором.

Texture2D drop_mark 🔗

Ікона показана до того, що вкладка перетягування (див. drag_to_rearrange_enabled).

Texture2D increment 🔗

Ікона для правої стрілки, яка з'являється, коли є занадто багато вкладок, щоб відповідати в ширину контейнера. Коли кнопка вимкнена (тобто остання вкладка видима) вона з'являється напівпрозорою.

Texture2D increment_highlight 🔗

Ікона для правої стрілки, яка з'являється, коли є занадто багато вкладок, щоб відповідати в ширину контейнера. Використовуються при натисканні кнопки з курсором.

Texture2D menu 🔗

Піктограма кнопки меню (див. set_popup()).

Texture2D menu_highlight 🔗

Ікона для кнопки меню (див. set_popup()), коли він переховається курсором.

StyleBox panel 🔗

Стиль для заповнення фону.

StyleBox tab_disabled 🔗

Стиль відключених вкладок.

StyleBox tab_focus 🔗

StyleBox використовується при фокусі TabBar. tab_focus StyleBox відображається over бази StyleBox вибраної вкладки, тому частково прозора StyleBox повинна бути використана для забезпечення бази StyleBox. StyleBox, який добре працює для цього. Щоб вимкнути візуальний ефект фокусу, призначте ресурс StyleBoxEmpty. Зверніть увагу, що відключення візуального ефекту фокусу буде завдати шкоди клавіатурі / керованій навігації, тому це не рекомендується для причин доступності.

StyleBox tab_hovered 🔗

Стиль в даний час ховається вкладка.

Примітка: Цей стиль буде складений з такою ж шириною, як tab_unselected при мінімальному.

StyleBox tab_selected 🔗

Стиль вказаної вкладки.

StyleBox tab_unselected 🔗

Стиль іншого, невибрані вкладки.

StyleBox tabbar_background 🔗

Стиль для фонового заповнення площі TabBar.