TabBar

public TabBar();

Создаёт пустую полосу: TabCount = 0, CurrentTab = PreviousTab = -1, DeselectEnabled = false. Дочерние Control не становятся страницами автоматически.

public bool ClipTabs { get; set; }

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

public bool CloseWithMiddleMouse { get; set; }

Разрешает запрос закрытия средней кнопкой, true по умолчанию. Не удаляет запись автоматически и не задаёт видимость кнопки закрытия.

public int CurrentTab { get; set; }

Индекс выбора, -1 без выбора. Прямой setter допускает hidden/disabled; для -1 нужны DeselectEnabled либо отсутствие доступных записей. Испускает TabSelected даже при том же индексе, TabChanged только при смене. Первый запрос до инициализации может откладываться.

public bool DeselectEnabled { get; set; }

Разрешает выбор -1 при доступных вкладках, false по умолчанию. Выключение при отсутствии выбора пытается выбрать следующую доступную с начала списка.

public bool DragToRearrangeEnabled { get; set; }

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

public int MaxTabWidth { get; set; }

Предел ширины для сокращения текста заголовков в пикселях, 0 по умолчанию отключает индивидуальный предел. Требуется ≥ 0. Иконки, кнопки и поля сохраняют свой минимум, поэтому полный заголовок может быть шире этого числа. Учитывается также доступный максимум раскладки.

public bool ScrollToSelected { get; set; }

Автоматически показывать выбранный заголовок, true по умолчанию. Включение сразу вызывает EnsureTabVisible для текущего индекса. false сохраняет выбор, но не гарантирует его видимость; прямой EnsureTabVisible доступен.

public bool ScrollingEnabled { get; set; }

Разрешает прокрутку полосы колесом/жестами ввода, true по умолчанию. Не запрещает EnsureTabVisible или автоматическую прокрутку к CurrentTab и не скрывает кнопки переполнения.

public bool SelectWithRmb { get; set; }

Разрешает выбор правой кнопкой, false по умолчанию. Сигнал TabRmbClicked и показ собственного меню — отдельные действия; программный CurrentTab не ограничивается этим флагом.

public bool SwitchOnDragHover { get; set; }

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

public TabBar.AlignmentMode TabAlignment { get; set; }

Горизонтальное выравнивание заголовков Left/Center/Right, Left по умолчанию. Направление раскладки учитывается отдельно; это не выравнивание пользовательских страниц.

public TabBar.CloseButtonDisplayPolicy TabCloseDisplayPolicy { get; set; }

Показ встроенной кнопки закрытия: ShowNever по умолчанию, ShowActiveOnly или ShowAlways. Нажатие сообщает TabClosePressed; удаление реализует приложение.

public int TabCount { get; set; }

Количество записей, включая hidden/disabled, 0 по умолчанию. Setter требует число ≥ 0: растит пустыми вкладками или удаляет хвост, ограничивает CurrentTab. Обычно меняет выбор без сигналов; при первом применении может выполнить отложенный CurrentTab.

public TabBar.SizingMode TabSizing { get; set; }

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

public int TabsRearrangeGroup { get; set; }

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

public void AddTab(string title = "", Texture2D icon = null);

Добавляет запись в конец с заголовком и необязательной общей иконкой. Если это первая вкладка и DeselectEnabled выключен, она выбирается; внутри дерева испускаются сигналы выбора. Не создаёт страницу.

public void ClearTabs();

Удаляет все записи и сбрасывает current/previous в -1, смещение в 0. Не испускает TabChanged/TabSelected и не удаляет дочерние Control. Обновляйте собственную страницу явно.

public void EnsureTabVisible(int idx);

Подстраивает индекс прокрутки для указанного заголовка без изменения CurrentTab. Работает в дереве при видимых кнопках переполнения, независимо от ScrollingEnabled. Для -1, hidden или уже находящегося в окне индекса ничего не делает. Не обещает полное размещение заголовка шире полосы.

public bool GetClipTabs();

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

public bool GetCloseWithMiddleMouse();

Разрешает запрос закрытия средней кнопкой, true по умолчанию. Не удаляет запись автоматически и не задаёт видимость кнопки закрытия.

public int GetCurrentTab();

Индекс выбора, -1 без выбора. Прямой setter допускает hidden/disabled; для -1 нужны DeselectEnabled либо отсутствие доступных записей. Испускает TabSelected даже при том же индексе, TabChanged только при смене. Первый запрос до инициализации может откладываться.

public bool GetDeselectEnabled();

Разрешает выбор -1 при доступных вкладках, false по умолчанию. Выключение при отсутствии выбора пытается выбрать следующую доступную с начала списка.

public bool GetDragToRearrangeEnabled();

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

public int GetMaxTabWidth();

Предел ширины для сокращения текста заголовков в пикселях, 0 по умолчанию отключает индивидуальный предел. Требуется ≥ 0. Иконки, кнопки и поля сохраняют свой минимум, поэтому полный заголовок может быть шире этого числа. Учитывается также доступный максимум раскладки.

public bool GetOffsetButtonsVisible();

Показываются ли кнопки переполнения после расчёта геометрии. Это не настройка ScrollingEnabled и не признак того, что выбранная вкладка видна.

public int GetPreviousTab();

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

public bool GetScrollToSelected();

Автоматически показывать выбранный заголовок, true по умолчанию. Включение сразу вызывает EnsureTabVisible для текущего индекса. false сохраняет выбор, но не гарантирует его видимость; прямой EnsureTabVisible доступен.

public bool GetScrollingEnabled();

Разрешает прокрутку полосы колесом/жестами ввода, true по умолчанию. Не запрещает EnsureTabVisible или автоматическую прокрутку к CurrentTab и не скрывает кнопки переполнения.

public bool GetSelectWithRmb();

Разрешает выбор правой кнопкой, false по умолчанию. Сигнал TabRmbClicked и показ собственного меню — отдельные действия; программный CurrentTab не ограничивается этим флагом.

public bool GetSwitchOnDragHover();

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

public TabBar.AlignmentMode GetTabAlignment();

Горизонтальное выравнивание заголовков Left/Center/Right, Left по умолчанию. Направление раскладки учитывается отдельно; это не выравнивание пользовательских страниц.

public Texture2D GetTabButtonIcon(int tabIdx);

Общая Texture2D дополнительной кнопки либо null, не основная иконка.

public TabBar.CloseButtonDisplayPolicy GetTabCloseDisplayPolicy();

Показ встроенной кнопки закрытия: ShowNever по умолчанию, ShowActiveOnly или ShowAlways. Нажатие сообщает TabClosePressed; удаление реализует приложение.

public int GetTabCount();

Количество записей, включая hidden/disabled, 0 по умолчанию. Setter требует число ≥ 0: растит пустыми вкладками или удаляет хвост, ограничивает CurrentTab. Обычно меняет выбор без сигналов; при первом применении может выполнить отложенный CurrentTab.

public Texture2D GetTabIcon(int tabIdx);

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

public int GetTabIconMaxWidth(int tabIdx);

Сохранённый индивидуальный предел ширины, не фактическая ширина с учётом темы.

public int GetTabIdxAtPoint(Vector2 point);

Индекс видимого в текущем окне заголовка под локальной точкой или -1. Hidden исключаются, disabled могут возвращаться. Это геометрический поиск, не переключение и не проверка разрешения выбора.

public string GetTabLanguage(int tabIdx);

Возвращает язык shaping вкладки либо пустую строку для локали элемента.

public Variant GetTabMetadata(int tabIdx);

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

public int GetTabOffset();

Возвращает текущий индекс начала прокручиваемого окна вкладок, не смещение в пикселях. Индекс учитывает полный список, включая скрытые записи.

public Rect2 GetTabRect(int tabIdx);

Возвращает прямоугольник заголовка в локальных координатах TabBar по текущему кэшу раскладки. Отрицательный индекс отсчитывается с конца (-1 — последняя запись). Прямоугольник вне текущего окна/hidden не является доказательством видимости или попадания; используйте GetTabIdxAtPoint для поиска под точкой.

public TabBar.SizingMode GetTabSizing();

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

public Control.TextDirection GetTabTextDirection(int tabIdx);

Возвращает сохранённое направление текста заголовка, Inherited по умолчанию.

public string GetTabTitle(int tabIdx);

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

public string GetTabTooltip(int tabIdx);

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

public int GetTabsRearrangeGroup();

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

public bool IsTabDisabled(int tabIdx);

Возвращает disabled-флаг записи, отдельно от hidden и текущего выбора.

public bool IsTabHidden(int tabIdx);

Возвращает hidden-флаг заголовка, не видимость связанной страницы приложения.

public void MoveTab(int from, int to);

Перемещает всю запись с metadata/флагами на конечный индекс to, оба индекса 0…TabCount-1. Сохраняет выбранную запись, корректируя current/previous; TabChanged/TabSelected/ActiveTabRearranged сам не испускает.

public void RemoveTab(int tabIdx);

Удаляет существующую запись. Индексы после неё сдвигаются; current/previous корректируются. Если удалена сама текущая вкладка, внутри дерева испускает TabChanged без TabSelected и ищет доступную замену. При удалении перед текущей индекс может измениться без сигнала.

public bool SelectNextAvailable();

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

public bool SelectPreviousAvailable();

Выбирает предыдущую по индексу запись без hidden/disabled. Не переходит по кругу; при CurrentTab = -1 возвращает false.

public void SetClipTabs(bool clipTabs);

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

public void SetCloseWithMiddleMouse(bool enabled);

Разрешает запрос закрытия средней кнопкой, true по умолчанию. Не удаляет запись автоматически и не задаёт видимость кнопки закрытия.

public void SetCurrentTab(int tabIdx);

Индекс выбора, -1 без выбора. Прямой setter допускает hidden/disabled; для -1 нужны DeselectEnabled либо отсутствие доступных записей. Испускает TabSelected даже при том же индексе, TabChanged только при смене. Первый запрос до инициализации может откладываться.

public void SetDeselectEnabled(bool enabled);

Разрешает выбор -1 при доступных вкладках, false по умолчанию. Выключение при отсутствии выбора пытается выбрать следующую доступную с начала списка.

public void SetDragToRearrangeEnabled(bool enabled);

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

public void SetMaxTabWidth(int width);

Предел ширины для сокращения текста заголовков в пикселях, 0 по умолчанию отключает индивидуальный предел. Требуется ≥ 0. Иконки, кнопки и поля сохраняют свой минимум, поэтому полный заголовок может быть шире этого числа. Учитывается также доступный максимум раскладки.

public void SetScrollToSelected(bool enabled);

Автоматически показывать выбранный заголовок, true по умолчанию. Включение сразу вызывает EnsureTabVisible для текущего индекса. false сохраняет выбор, но не гарантирует его видимость; прямой EnsureTabVisible доступен.

public void SetScrollingEnabled(bool enabled);

Разрешает прокрутку полосы колесом/жестами ввода, true по умолчанию. Не запрещает EnsureTabVisible или автоматическую прокрутку к CurrentTab и не скрывает кнопки переполнения.

public void SetSelectWithRmb(bool enabled);

Разрешает выбор правой кнопкой, false по умолчанию. Сигнал TabRmbClicked и показ собственного меню — отдельные действия; программный CurrentTab не ограничивается этим флагом.

public void SetSwitchOnDragHover(bool enabled);

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

public void SetTabAlignment(TabBar.AlignmentMode alignment);

Горизонтальное выравнивание заголовков Left/Center/Right, Left по умолчанию. Направление раскладки учитывается отдельно; это не выравнивание пользовательских страниц.

public void SetTabButtonIcon(int tabIdx, Texture2D icon);

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

public void SetTabCloseDisplayPolicy(TabBar.CloseButtonDisplayPolicy policy);

Показ встроенной кнопки закрытия: ShowNever по умолчанию, ShowActiveOnly или ShowAlways. Нажатие сообщает TabClosePressed; удаление реализует приложение.

public void SetTabCount(int count);

Количество записей, включая hidden/disabled, 0 по умолчанию. Setter требует число ≥ 0: растит пустыми вкладками или удаляет хвост, ограничивает CurrentTab. Обычно меняет выбор без сигналов; при первом применении может выполнить отложенный CurrentTab.

public void SetTabDisabled(int tabIdx, bool disabled);

Меняет disabled-флаг для пользовательского выбора/доступной навигации. Не снимает уже текущий выбор и не запрещает прямой CurrentTab.

public void SetTabHidden(int tabIdx, bool hidden);

Скрывает заголовок без удаления записи. Не меняет TabCount и в самостоятельном TabBar не переключает текущий выбор автоматически.

public void SetTabIcon(int tabIdx, Texture2D icon);

Назначает общую основную Texture2D, null убирает её. Ресурс не копируется; setter обновляет геометрию и минимум. Для ограничения рисунка используйте SetTabIconMaxWidth, а не изменение исходной текстуры.

public void SetTabIconMaxWidth(int tabIdx, int width);

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

public void SetTabLanguage(int tabIdx, string language);

Задаёт язык shaping конкретного заголовка; пустая строка использует локаль элемента. Не переводит исходную строку и не переключает локаль приложения.

public void SetTabMetadata(int tabIdx, Variant metadata);

Задаёт Variant-данные записи, например собственный постоянный ID. MoveTab переносит их вместе с записью. Array/Dictionary остаются общими контейнерами; копируйте их отдельно при необходимости независимых данных.

public void SetTabSizing(TabBar.SizingMode tabSizing);

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

public void SetTabTextDirection(int tabIdx, Control.TextDirection direction);

Задаёт направление shaping конкретного заголовка. Inherited берёт направление раскладки; Ltr/Rtl не разворачивают исходную строку.

public void SetTabTitle(int tabIdx, string title);

Задаёт исходный заголовок и обновляет shaping/геометрию. Отображение может использовать перевод; индекс и metadata не меняются.

public void SetTabTooltip(int tabIdx, string tooltip);

Задаёт отдельную подсказку заголовка. Не меняет заголовок, индекс или metadata.

public void SetTabsRearrangeGroup(int groupId);

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

public event TabBar.ActiveTabRearrangedEventHandler ActiveTabRearranged;

Уведомление пути перетаскивания о новом индексе активируемой вкладки. MoveTab из кода сам не испускает его. После перестановки заново разрешайте собственный ID через metadata.

public event TabBar.TabButtonPressedEventHandler TabButtonPressed;

Нажата дополнительная кнопка SetTabButtonIcon. Это отдельный сигнал от TabClosePressed; автоматического удаления нет.

public event TabBar.TabChangedEventHandler TabChanged;

Уведомление пути CurrentTab при смене выбора или RemoveTab при удалении текущей записи. Не универсальный наблюдатель индекса: MoveTab, ClearTabs и обычный SetTabCount могут менять состояние без сигнала. -1 означает отсутствие выбора.

public event TabBar.TabClickedEventHandler TabClicked;

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

public event TabBar.TabClosePressedEventHandler TabClosePressed;

Запрос закрытия от кнопки/разрешённого среднего клика. Сам не удаляет запись. Проверьте возможность закрытия, затем явно удалите модель/страницу и вызовите RemoveTab.

public event TabBar.TabHoveredEventHandler TabHovered;

Указатель вошёл в другой заголовок. Не является выбором; при уходе с полосы отдельное событие с -1 не гарантируется. Disabled-заголовок также может участвовать в геометрии наведения.

public event TabBar.TabRmbClickedEventHandler TabRmbClicked;

Клик правой кнопкой по вкладке. SelectWithRmb отдельно определяет выбор правой кнопкой; сигнал можно использовать для собственного контекстного меню.

public event TabBar.TabSelectedEventHandler TabSelected;

Запрос выбора CurrentTab, включая повторный индекс и программный вызов. При смене приходит перед TabChanged. Структурные MoveTab/RemoveTab/ClearTabs/обычный SetTabCount не обязаны его испускать.