TabContainer

public TabContainer();

Создаёт пустой контейнер: CurrentTab = -1, TabsVisible = true, DeselectEnabled = false, UseHiddenTabsForMinSize = false. Страницы добавляются дочерними Control.

public bool AllTabsInFront { get; set; }

Устаревшая настройка без действия в текущей реализации. Getter возвращает false; setter не меняет порядок, а true может вывести предупреждение. Не используйте для управления слоями или порядком страниц.

public bool ClipTabs { get; set; }

Ограничивать полосу доступной шириной, true по умолчанию. При нехватке места часть заголовков прокручивается; false включает их ширину в минимум и может расширить контейнер. Не является ClipContents для страниц.

public int CurrentTab { get; set; }

Индекс выбранной страницы, -1 в пустом контейнере. Допустим индекс 0…GetTabCount()-1; -1 требует разрешённого снятия выбора либо отсутствия доступных вкладок. Setter может выбрать disabled-вкладку. До входа в дерево запрос откладывается. Повторный индекс испускает TabSelected без TabChanged.

public bool DeselectEnabled { get; set; }

Разрешает отсутствие выбранной страницы, false по умолчанию. Для явного снятия выбора включите флаг и задайте CurrentTab = -1. Выключение при -1 пытается выбрать первую доступную вкладку.

public bool DragToRearrangeEnabled { get; set; }

Разрешает пользовательское перетаскивание вкладок для перестановки, false по умолчанию. Не запрещает MoveChild из кода. Для переноса между контейнерами дополнительно настройте одинаковую TabsRearrangeGroup.

public bool SwitchOnDragHover { get; set; }

Переключать вкладку при наведении во время перетаскивания содержимого, true по умолчанию. Не определяет допустимость drop и не включает перестановку вкладок. Перетаскивание самих вкладок имеет отдельный путь.

public TabBar.AlignmentMode TabAlignment { get; set; }

Выравнивание заголовков Left/Center/Right, Left по умолчанию. Работает с внутренним TabBar и полями темы, не выравнивает содержимое страниц. Направление раскладки учитывается отдельно.

public Control.FocusModeEnum TabFocusMode { get; set; }

FocusMode внутренней полосы, All по умолчанию. None убирает фокус с заголовков, но не меняет FocusMode кнопок/полей внутри страниц.

public TabBar.SizingMode TabSizing { get; set; }

Режим ширины заголовков, FitContent по умолчанию. FitContent — индивидуальная ширина содержимого; Uniform — всем ширина самого широкого. Justify пропорционально расширяет ширины при свободном месте; Expand распределяет его поровну, если самый широкий заголовок помещается, иначе использует FitContent. Это не размер страниц.

public TabContainer.TabPosition TabsPosition { get; set; }

Полоса вкладок сверху или снизу: Top по умолчанию. Bottom перемещает заголовки и переворачивает их style-box по вертикали; содержимое страницы не переворачивается. Переразметка откладывается.

public int TabsRearrangeGroup { get; set; }

Группа переноса вкладок между контейнерами; -1 по умолчанию запрещает межконтейнерный перенос. Задайте одинаковый неотрицательный ID и разрешите DragToRearrangeEnabled у участников. Это не группа Entity и не постоянный ID вкладки.

public bool TabsVisible { get; set; }

Показывать полосу заголовков, true по умолчанию. false убирает полосу и её место в раскладке, сохраняя выбранную страницу и её индекс.

public bool UseHiddenTabsForMinSize { get; set; }

Учитывать минимумы невидимых, включая неактивные, страниц; false по умолчанию. true берёт покомпонентный максимум размеров страниц и помогает избежать изменения минимума при переключении.

public bool AreTabsVisible();

Показывать полосу заголовков, true по умолчанию. false убирает полосу и её место в раскладке, сохраняя выбранную страницу и её индекс.

public bool GetClipTabs();

Ограничивать полосу доступной шириной, true по умолчанию. При нехватке места часть заголовков прокручивается; false включает их ширину в минимум и может расширить контейнер. Не является ClipContents для страниц.

public int GetCurrentTab();

Индекс выбранной страницы, -1 в пустом контейнере. Допустим индекс 0…GetTabCount()-1; -1 требует разрешённого снятия выбора либо отсутствия доступных вкладок. Setter может выбрать disabled-вкладку. До входа в дерево запрос откладывается. Повторный индекс испускает TabSelected без TabChanged.

public Control GetCurrentTabControl();

Возвращает текущую дочернюю страницу либо null при отсутствии выбора. Это существующий Control, не новый экземпляр.

public bool GetDeselectEnabled();

Разрешает отсутствие выбранной страницы, false по умолчанию. Для явного снятия выбора включите флаг и задайте CurrentTab = -1. Выключение при -1 пытается выбрать первую доступную вкладку.

public bool GetDragToRearrangeEnabled();

Разрешает пользовательское перетаскивание вкладок для перестановки, false по умолчанию. Не запрещает MoveChild из кода. Для переноса между контейнерами дополнительно настройте одинаковую TabsRearrangeGroup.

public Popup GetPopup();

Возвращает назначенный общий Popup либо null. Контейнер хранит ID объекта и не владеет его временем жизни; отсоединяйте через SetPopup(null) перед освобождением меню.

public int GetPreviousTab();

Индекс до последнего присваивания выбора. Повторная запись CurrentTab обновляет previous тем же индексом; это не обязательно последняя другая страница и не постоянный ID.

public bool GetSwitchOnDragHover();

Переключать вкладку при наведении во время перетаскивания содержимого, true по умолчанию. Не определяет допустимость drop и не включает перестановку вкладок. Перетаскивание самих вкладок имеет отдельный путь.

public TabBar.AlignmentMode GetTabAlignment();

Выравнивание заголовков Left/Center/Right, Left по умолчанию. Работает с внутренним TabBar и полями темы, не выравнивает содержимое страниц. Направление раскладки учитывается отдельно.

public TabBar GetTabBar();

Общий внутренний TabBar. Не освобождайте его и не меняйте число вкладок напрямую: заголовки должны соответствовать дочерним страницам TabContainer. Для выбора и свойств вкладок используйте методы контейнера.

public Texture2D GetTabButtonIcon(int tabIdx);

Возвращает общую иконку дополнительной кнопки либо null. Не возвращает основную иконку вкладки.

public Control GetTabControl(int tabIdx);

Возвращает дочернюю страницу по индексу вкладки. Для отрицательного/несуществующего индекса возвращает null. Общая ссылка: не освобождайте её, пока страницей владеет контейнер.

public int GetTabCount();

Число страниц-вкладок, включая hidden/disabled. Это не число всех Entity-детей и не число видимых заголовков.

public Control.FocusModeEnum GetTabFocusMode();

FocusMode внутренней полосы, All по умолчанию. None убирает фокус с заголовков, но не меняет FocusMode кнопок/полей внутри страниц.

public Texture2D GetTabIcon(int tabIdx);

Возвращает общую основную иконку заголовка либо null. Это отдельный слот от дополнительной кнопки SetTabButtonIcon.

public int GetTabIconMaxWidth(int tabIdx);

Возвращает сохранённое индивидуальное ограничение ширины, 0 по умолчанию. Это не фактическая ширина рисунка и не итог с учётом темы.

public int GetTabIdxAtPoint(Vector2 point);

Возвращает индекс заголовка под точкой либо -1. В текущей реализации точка передаётся напрямую внутреннему TabBar: используйте его локальные координаты, например GetTabBar().GetLocalMousePosition(), а не координаты страницы/экрана/всего контейнера. Это важно при Bottom и смещении полосы. Отключённый заголовок всё ещё может находиться под точкой.

public int GetTabIdxFromControl(Control control);

Находит актуальный индекс непосредственной дочерней страницы. Требуется ненулевой Control с этим родителем; неправильный родитель сообщает ошибку и возвращает -1. Для перестановок храните ссылку/ID страницы, а не прежний индекс.

public Variant GetTabMetadata(int tabIdx);

Возвращает Variant-данные вкладки. Если metadata не назначена, возвращает Nil. Для собственного ID используйте ожидаемый тип и проверяйте его перед преобразованием.

public TabBar.SizingMode GetTabSizing();

Режим ширины заголовков, FitContent по умолчанию. FitContent — индивидуальная ширина содержимого; Uniform — всем ширина самого широкого. Justify пропорционально расширяет ширины при свободном месте; Expand распределяет его поровну, если самый широкий заголовок помещается, иначе использует FitContent. Это не размер страниц.

public string GetTabTitle(int tabIdx);

Возвращает сохранённый заголовок указанной вкладки, отдельно от имени страницы и её постоянного ID.

public string GetTabTooltip(int tabIdx);

Возвращает сохранённую подсказку заголовка.

public TabContainer.TabPosition GetTabsPosition();

Полоса вкладок сверху или снизу: Top по умолчанию. Bottom перемещает заголовки и переворачивает их style-box по вертикали; содержимое страницы не переворачивается. Переразметка откладывается.

public int GetTabsRearrangeGroup();

Группа переноса вкладок между контейнерами; -1 по умолчанию запрещает межконтейнерный перенос. Задайте одинаковый неотрицательный ID и разрешите DragToRearrangeEnabled у участников. Это не группа Entity и не постоянный ID вкладки.

public bool GetUseHiddenTabsForMinSize();

Учитывать минимумы невидимых, включая неактивные, страниц; false по умолчанию. true берёт покомпонентный максимум размеров страниц и помогает избежать изменения минимума при переключении.

public bool IsAllTabsInFront();

Устаревшая настройка без действия в текущей реализации. Getter возвращает false; setter не меняет порядок, а true может вывести предупреждение. Не используйте для управления слоями или порядком страниц.

public bool IsTabDisabled(int tabIdx);

Возвращает флаг disabled заголовка; это не Visible страницы и не гарантия, что она не выбрана.

public bool IsTabHidden(int tabIdx);

Флаг скрытия заголовка. Не равен !Visible: неактивная страница обычно невидима и с видимым заголовком.

public bool SelectNextAvailable();

Выбирает следующую по индексу вкладку без hidden/disabled; возвращает true при успехе. Не переходит с конца к началу. При CurrentTab = -1 ищет от первой вкладки.

public bool SelectPreviousAvailable();

Выбирает предыдущую по индексу доступную вкладку, пропуская hidden/disabled. Возвращает false без смены выбора, если подходящей вкладки слева нет; не переходит по кругу.

public void SetAllTabsInFront(bool isFront);

Устаревшая настройка без действия в текущей реализации. Getter возвращает false; setter не меняет порядок, а true может вывести предупреждение. Не используйте для управления слоями или порядком страниц.

public void SetClipTabs(bool clipTabs);

Ограничивать полосу доступной шириной, true по умолчанию. При нехватке места часть заголовков прокручивается; false включает их ширину в минимум и может расширить контейнер. Не является ClipContents для страниц.

public void SetCurrentTab(int tabIdx);

Индекс выбранной страницы, -1 в пустом контейнере. Допустим индекс 0…GetTabCount()-1; -1 требует разрешённого снятия выбора либо отсутствия доступных вкладок. Setter может выбрать disabled-вкладку. До входа в дерево запрос откладывается. Повторный индекс испускает TabSelected без TabChanged.

public void SetDeselectEnabled(bool enabled);

Разрешает отсутствие выбранной страницы, false по умолчанию. Для явного снятия выбора включите флаг и задайте CurrentTab = -1. Выключение при -1 пытается выбрать первую доступную вкладку.

public void SetDragToRearrangeEnabled(bool enabled);

Разрешает пользовательское перетаскивание вкладок для перестановки, false по умолчанию. Не запрещает MoveChild из кода. Для переноса между контейнерами дополнительно настройте одинаковую TabsRearrangeGroup.

public void SetPopup(Entity popup);

Назначает ссылку на существующий Popup, например PopupMenu; null отсоединяет. Параметр имеет тип Entity, но другой тип очищает назначение. Не добавляет меню в дерево, не меняет родителя, не открывает и не освобождает его. Добавьте Popup в дерево самостоятельно и отсоедините до его освобождения.

public void SetSwitchOnDragHover(bool enabled);

Переключать вкладку при наведении во время перетаскивания содержимого, true по умолчанию. Не определяет допустимость drop и не включает перестановку вкладок. Перетаскивание самих вкладок имеет отдельный путь.

public void SetTabAlignment(TabBar.AlignmentMode alignment);

Выравнивание заголовков Left/Center/Right, Left по умолчанию. Работает с внутренним TabBar и полями темы, не выравнивает содержимое страниц. Направление раскладки учитывается отдельно.

public void SetTabButtonIcon(int tabIdx, Texture2D icon);

Задаёт иконку отдельной кнопки в заголовке; null убирает кнопку. Основная иконка не меняется. Нажатие сообщает TabButtonPressed; удаление/закрытие страницы реализуйте сами.

public void SetTabDisabled(int tabIdx, bool disabled);

Запрещает выбор заголовка пользователем и доступной навигацией. Не скрывает страницу и не переключает уже выбранную вкладку; программный CurrentTab всё ещё может её выбрать.

public void SetTabFocusMode(Control.FocusModeEnum focusMode);

FocusMode внутренней полосы, All по умолчанию. None убирает фокус с заголовков, но не меняет FocusMode кнопок/полей внутри страниц.

public void SetTabHidden(int tabIdx, bool hidden);

Скрывает/возвращает заголовок, не удаляя страницу и не меняя число вкладок. Изменение также скрывает страницу и запускает согласование выбора; при скрытии текущей может выбрать другую. Для подготовки задавайте после добавления страницы.

public void SetTabIcon(int tabIdx, Texture2D icon);

Назначает общую Texture2D основной иконке заголовка; null убирает её. Требуется существующая страница. Ресурс не копируется; назначение обновляет поля/перерисовку. Размер ограничивается темой и SetTabIconMaxWidth.

public void SetTabIconMaxWidth(int tabIdx, int width);

Максимальная ширина основной иконки в локальных пикселях. 0 означает отсутствие индивидуального ограничения; положительное значение сохраняет пропорции и сочетается с более строгим icon_max_width темы. Не увеличивает маленькую иконку и не меняет Texture2D.

public void SetTabMetadata(int tabIdx, Variant metadata);

Сохраняет Variant-данные вкладки, например собственный постоянный ID. Данные относятся к записи вкладки и перемещаются с ней; текущий индекс постоянным ключом не становится. Ссылочные контейнеры внутри Variant могут оставаться общими.

public void SetTabSizing(TabBar.SizingMode tabSizing);

Режим ширины заголовков, FitContent по умолчанию. FitContent — индивидуальная ширина содержимого; Uniform — всем ширина самого широкого. Justify пропорционально расширяет ширины при свободном месте; Expand распределяет его поровну, если самый широкий заголовок помещается, иначе использует FitContent. Это не размер страниц.

public void SetTabTitle(int tabIdx, string title);

Задаёт заголовок, не переименовывая Control страницы. Собственный заголовок сохраняется при переименовании страницы; присваивание текущего Name возвращает отслеживание имени.

public void SetTabTooltip(int tabIdx, string tooltip);

Задаёт подсказку заголовка, не меняя заголовок, имя или индекс. Требуется существующая вкладка.

public void SetTabsPosition(TabContainer.TabPosition tabsPosition);

Полоса вкладок сверху или снизу: Top по умолчанию. Bottom перемещает заголовки и переворачивает их style-box по вертикали; содержимое страницы не переворачивается. Переразметка откладывается.

public void SetTabsRearrangeGroup(int groupId);

Группа переноса вкладок между контейнерами; -1 по умолчанию запрещает межконтейнерный перенос. Задайте одинаковый неотрицательный ID и разрешите DragToRearrangeEnabled у участников. Это не группа Entity и не постоянный ID вкладки.

public void SetTabsVisible(bool visible);

Показывать полосу заголовков, true по умолчанию. false убирает полосу и её место в раскладке, сохраняя выбранную страницу и её индекс.

public void SetUseHiddenTabsForMinSize(bool enabled);

Учитывать минимумы невидимых, включая неактивные, страниц; false по умолчанию. true берёт покомпонентный максимум размеров страниц и помогает избежать изменения минимума при переключении.

public event TabContainer.ActiveTabRearrangedEventHandler ActiveTabRearranged;

Уведомление пути перетаскивания о новом индексе активируемой вкладки. Не является общим сигналом любой перестановки: MoveChild из кода сам его не испускает. После изменения порядка заново разрешайте индексы по ссылке/metadata.

public event Action PrePopupPressed;

Вызывается кнопкой дополнительного меню перед позиционированием и открытием назначенного Popup. Используйте для обновления пунктов. Не освобождайте/не подменяйте Popup внутри обработчика: текущий путь уже получил ссылку на открываемый объект. SetPopup сам сигнал не испускает.

public event TabContainer.TabButtonPressedEventHandler TabButtonPressed;

Нажата дополнительная кнопка, созданная через SetTabButtonIcon. Передаёт индекс вкладки; контейнер сам не удаляет страницу. Сохраните ссылку/metadata до перестановки или удаления.

public event TabContainer.TabChangedEventHandler TabChanged;

Индекс выбранной вкладки изменился, включая программный выбор. Контейнер обновляет видимость страниц перед этим уведомлением; -1 означает отсутствие выбранной страницы. Не испускается при записи того же индекса.

public event TabContainer.TabClickedEventHandler TabClicked;

Пользователь кликнул заголовок вкладки. Программный CurrentTab не испускает этот сигнал; клик по уже выбранной вкладке не обязательно меняет страницу.

public event TabContainer.TabHoveredEventHandler TabHovered;

Указатель навёлся на заголовок указанной вкладки. Это не выбор страницы и не сигнал изменения CurrentTab.

public event TabContainer.TabSelectedEventHandler TabSelected;

Выбор вкладки, включая повторный выбор того же индекса и программный CurrentTab. При смене приходит перед TabChanged и обновлением видимости страниц; для готовой смены страницы используйте TabChanged.