TreeItem
Строка Tree с ячейками, дочерними строками и явным временем жизни.
Создавайте TreeItem через Tree.CreateItem или CreateChild существующей строки. TreeItem наследуется от Object: это не Entity, не компонент и не ресурс с подсчётом ссылок. GetTree возвращает UI-контрол Tree, а не EntityTree. Полученные из дерева строки отдельно не освобождайте, пока они нужны интерфейсу.
CreateChild добавляет вложенную строку; GetParent, GetFirstChild, GetNext и GetPrev обходят структурную иерархию. GetNext/GetPrev возвращают соседей с тем же родителем. GetChildren создаёт новый массив ссылок на те же строки: очистка массива не удаляет строки, изменение строки через массив меняет исходное дерево.
Для изменения порядка используйте MoveBefore/MoveAfter. Для переноса через AddChild сначала вызовите RemoveChild у прежнего родителя: AddChild принимает только отсоединённый элемент без родителя и Tree. Отсоединение сохраняет потомков и значения, но владение их временем жизни переходит вызывающему коду. Освободите ненужное поддерево через Free; оно удалится целиком.
При присоединении к другому Tree ячейки всех потомков подгоняются под его Columns. Если колонок меньше, отброшенные значения не восстановятся при обратном переносе. После Tree.Clear или Free строки и её потомков повторно использовать нельзя. Долговременные данные храните в модели, а в Metadata — ключ для поиска записи.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Свойства4
CollapsedСвойство
public bool Collapsed { get; set; }Свёрнута ли ветвь; по умолчанию false. Строка остаётся, скрываются её потомки при видимом обходе и отображении. Изменение у присоединённой строки испускает Tree.ItemCollapsed; повторное значение и setter у отсоединённой строки ничего не делают. Если курсор внутри ветви, он может переместиться на эту строку.
CustomMinimumHeightСвойство
public int CustomMinimumHeight { get; set; }Дополнительный минимум высоты всей строки в пикселях, по умолчанию 0. Это не фиксированная высота: шрифт, иконки, кнопки и интервалы темы могут потребовать больше места. 0 снимает дополнительное требование.
DisableFoldingСвойство
public bool DisableFolding { get; set; }Убирает обычный элемент сворачивания этой строки. Не раскрывает уже свёрнутую ветвь и не запрещает программный Collapsed или SetCollapsedRecursive. Для принудительно раскрытой ветви отдельно задайте Collapsed = false.
VisibleСвойство
public bool Visible { get; set; }Собственный флаг показа строки, true по умолчанию. false не удаляет строку и не меняет Visible её потомков. Скрытие снимает флаги выбора самой строки, но не является полным сбросом выбора всех потомков. Для надёжного фильтра ветви отдельно определите правила очистки выбора.
Методы128
AddButton2 перегрузки
public void AddButton(int column, Texture2D button, int id, bool disabled, string tooltipText);Добавляет кнопку действия в колонку. button — непустая Texture2D, сохраняемая по ссылке. Отрицательный id заменяется текущим числом кнопок: уникальность не гарантируется. Задавайте явные уникальные ID команд; после удаления индексы сдвигаются, а ID сохраняются. Не испускает ButtonClicked или ItemEdited.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
button | Texture2D | — |
id | int | — |
disabled | bool | — |
tooltipText | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonНепустая Texture2D кнопки; сохраняется по ссылке.
idID команды. У AddButton отрицательное значение заменяется текущим числом кнопок; у GetButtonById это искомый ID.
disabledЗапретить пользовательскую активацию этой кнопки.
tooltipTextТекст подсказки; пустая строка означает отсутствие подсказки.
public void AddButton(int column, Texture2D button, int id = -1, bool disabled = false, string tooltipText = "", string description = "");Добавляет кнопку действия в колонку. button — непустая Texture2D, сохраняемая по ссылке. Отрицательный id заменяется текущим числом кнопок: уникальность не гарантируется. Задавайте явные уникальные ID команд; после удаления индексы сдвигаются, а ID сохраняются. Не испускает ButtonClicked или ItemEdited.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
button | Texture2D | — |
id | int | -1 |
disabled | bool | false |
tooltipText | string | "" |
description | string | "" |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonНепустая Texture2D кнопки; сохраняется по ссылке.
idID команды. У AddButton отрицательное значение заменяется текущим числом кнопок; у GetButtonById это искомый ID.
disabledЗапретить пользовательскую активацию этой кнопки.
tooltipTextТекст подсказки; пустая строка означает отсутствие подсказки.
descriptionОписание действия для средств доступности, отдельно от подсказки.
AddChildvoid
public void AddChild(TreeItem child);Присоединяет отсоединённое поддерево в конец списка детей. child должен быть без родителя и Tree. Новый Tree принимает владение; его Columns задаёт число ячеек всем потомкам, лишние данные теряются.
| Имя | Тип | По умолчанию |
|---|---|---|
child | TreeItem | — |
childПоддерево: для AddChild — отсоединённое, для RemoveChild — непосредственный ребёнок этой строки.
CallRecursive2 перегрузки
public void CallRecursive(StringName method, params Variant[] args);Вызывает один метод с одинаковыми аргументами у этой строки, затем у всех потомков в глубину, включая скрытые и свёрнутые ветви. Передавайте нативное имя из TreeItem.MethodName, например SetTooltipText, а не произвольное C#-имя. Не удаляйте строки и не меняйте список детей из вызываемого метода. Перегрузки с Variant[] и ReadOnlySpan<Variant> имеют одинаковый порядок вызовов и не собирают возвращаемые значения.
| Имя | Тип | По умолчанию |
|---|---|---|
method | StringName | — |
args | Variant[] | — |
methodНативное имя метода, предпочтительно константа TreeItem.MethodName.
argsАргументы метода, одинаковые для всех строк; массив или ReadOnlySpan действует на время вызова.
public void CallRecursive(StringName method, ReadOnlySpan<Variant> args);Вызывает один метод с одинаковыми аргументами у этой строки, затем у всех потомков в глубину, включая скрытые и свёрнутые ветви. Передавайте нативное имя из TreeItem.MethodName, например SetTooltipText, а не произвольное C#-имя. Не удаляйте строки и не меняйте список детей из вызываемого метода. Перегрузки с Variant[] и ReadOnlySpan<Variant> имеют одинаковый порядок вызовов и не собирают возвращаемые значения.
| Имя | Тип | По умолчанию |
|---|---|---|
method | StringName | — |
args | ReadOnlySpan<Variant> | — |
methodНативное имя метода, предпочтительно константа TreeItem.MethodName.
argsАргументы метода, одинаковые для всех строк; массив или ReadOnlySpan действует на время вызова.
ClearButtonsvoid
public void ClearButtons();Удаляет все кнопки действий этой строки во всех колонках. Не удаляет строку, её основную иконку или внешние ресурсы текстур. Для одной кнопки используйте EraseButton.
ClearCustomBgColorvoid
public void ClearCustomBgColor(int column);Удаляет локальную заливку/контур. Не удаляет CustomStylebox и не меняет тему или выделение строки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
ClearCustomColorvoid
public void ClearCustomColor(int column);Удаляет локальное переопределение цвета текста и возвращает выбор цвета теме, включая состояния выбора/наведения. GetCustomColor после этого возвращает чёрный маркер отсутствия настройки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
CreateChildTreeItem
public TreeItem CreateChild(int index = -1);Создаёт дочернюю строку. Отрицательный index добавляет в конец; индекс существующего ребёнка вставляет перед ним, индекс за концом добавляет в конец. Создавайте строки у элемента, уже присоединённого к Tree, чтобы получить его схему колонок.
| Имя | Тип | По умолчанию |
|---|---|---|
index | int | -1 |
indexСтруктурный индекс ребёнка. Для создания отрицательный добавляет в конец; для GetChild отрицательный отсчитывается с конца.
TreeItemСоздаёт дочернюю строку. Отрицательный index добавляет в конец; индекс существующего ребёнка вставляет перед ним, индекс за концом добавляет в конец. Создавайте строки у элемента, уже присоединённого к Tree, чтобы получить его схему колонок.
Deselectvoid
public void Deselect(int column);Снимает флаг ячейки, а в Row — всей строки, без сигналов выбора. В Multi одновременно ставит курсор на эту теперь невыбранную ячейку. Для полного сброса флагов и курсора используйте Tree.DeselectAll.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
EraseButtonvoid
public void EraseButton(int column, int buttonIndex);Удаляет кнопку по неотрицательному индексу в колонке. Индексы следующих кнопок уменьшаются, их ID остаются прежними. Перед следующей операцией по ID заново получите индекс через GetButtonById.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexНеотрицательный индекс кнопки в колонке, не ID команды.
GetAutoTranslateModeEntity.AutoTranslateModeEnum
public Entity.AutoTranslateModeEnum GetAutoTranslateMode(int column);Сохранённая политика перевода подписи, по умолчанию Inherit. Это не текущая локаль приложения и не подтверждение наличия перевода.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Entity.AutoTranslateModeEnumСохранённая политика перевода подписи, по умолчанию Inherit. Это не текущая локаль приложения и не подтверждение наличия перевода.
GetAutowrapModeTextServer.AutowrapMode
public TextServer.AutowrapMode GetAutowrapMode(int column);Сохранённый режим переноса, по умолчанию Off. Не сообщает число реально сформированных строк.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
TextServer.AutowrapModeСохранённый режим переноса, по умолчанию Off. Не сообщает число реально сформированных строк.
GetAutowrapTrimFlagsTextServer.LineBreakFlag
public TextServer.LineBreakFlag GetAutowrapTrimFlags(int column);Сохранённые trim-флаги после маскирования, не полный набор правил переноса текста.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
TextServer.LineBreakFlagСохранённые trim-флаги после маскирования, не полный набор правил переноса текста.
GetButtonTexture2D
public Texture2D GetButton(int column, int buttonIndex);Текстура кнопки по неотрицательному индексу. Возвращается общий ресурс, не копия изображения. Не путайте индекс с ID команды.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexНеотрицательный индекс кнопки в колонке, не ID команды.
Texture2DТекстура кнопки по неотрицательному индексу. Возвращается общий ресурс, не копия изображения. Не путайте индекс с ID команды.
GetButtonByIdint
public int GetButtonById(int column, int id);Индекс первой кнопки с указанным ID в колонке либо -1. Это обратное преобразование ID → индекс; при дубликатах возвращается только первая. Проверяйте -1 до вызова индексных методов.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
id | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
idID команды. У AddButton отрицательное значение заменяется текущим числом кнопок; у GetButtonById это искомый ID.
intИндекс первой кнопки с указанным ID в колонке либо -1. Это обратное преобразование ID → индекс; при дубликатах возвращается только первая. Проверяйте -1 до вызова индексных методов.
GetButtonColorColor
public Color GetButtonColor(int column, int id);Цветовой множитель кнопки. Важно: C#-параметр назван id, но фактически принимает неотрицательный индекс. Для ID команды сначала вызовите GetButtonById и проверьте результат на -1.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
id | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
idНесмотря на имя id, здесь нужен неотрицательный индекс кнопки.
ColorЦветовой множитель кнопки. Важно: C#-параметр назван id, но фактически принимает неотрицательный индекс. Для ID команды сначала вызовите GetButtonById и проверьте результат на -1.
GetButtonCountint
public int GetButtonCount(int column);Число кнопок действий в колонке. Основная иконка и оформление CustomAsButton в этот счётчик не входят.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
intЧисло кнопок действий в колонке. Основная иконка и оформление CustomAsButton в этот счётчик не входят.
GetButtonIdint
public int GetButtonId(int column, int buttonIndex);ID команды кнопки по неотрицательному индексу. Это сохранённое значение, не текущий индекс; одинаковые ID технически допускаются.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexНеотрицательный индекс кнопки в колонке, не ID команды.
intID команды кнопки по неотрицательному индексу. Это сохранённое значение, не текущий индекс; одинаковые ID технически допускаются.
GetButtonTooltipTextstring
public string GetButtonTooltipText(int column, int buttonIndex);Исходный текст подсказки кнопки по неотрицательному индексу. Не возвращает description для доступности и не принимает ID команды.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexНеотрицательный индекс кнопки в колонке, не ID команды.
stringИсходный текст подсказки кнопки по неотрицательному индексу. Не возвращает description для доступности и не принимает ID команды.
GetCellModeTreeItem.TreeCellMode
public TreeItem.TreeCellMode GetCellMode(int column);Текущий режим ячейки: String, Check, Range, Icon или Custom. Новая ячейка использует String; режим не равен разрешению редактирования.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
TreeItem.TreeCellModeТекущий режим ячейки: String, Check, Range, Icon или Custom. Новая ячейка использует String; режим не равен разрешению редактирования.
GetChildTreeItem
public TreeItem GetChild(int index);Возвращает непосредственного ребёнка по структурному индексу. Отрицательный индекс отсчитывается с конца: -1 — последний. Индекс должен попадать в существующий список.
| Имя | Тип | По умолчанию |
|---|---|---|
index | int | — |
indexСтруктурный индекс ребёнка. Для создания отрицательный добавляет в конец; для GetChild отрицательный отсчитывается с конца.
TreeItemВозвращает непосредственного ребёнка по структурному индексу. Отрицательный индекс отсчитывается с конца: -1 — последний. Индекс должен попадать в существующий список.
GetChildCountint
public int GetChildCount();Число непосредственных детей, включая скрытых и детей свёрнутой строки. Не считает всех потомков рекурсивно.
intЧисло непосредственных детей, включая скрытых и детей свёрнутой строки. Не считает всех потомков рекурсивно.
GetChildrenReckfell.Collections.Array<TreeItem>
public Reckfell.Collections.Array<TreeItem> GetChildren();Новый массив ссылок на непосредственных детей в структурном порядке. Изменение массива не меняет иерархию; сами TreeItem общие и сохраняют прежнего владельца.
Reckfell.Collections.Array<TreeItem>Новый массив ссылок на непосредственных детей в структурном порядке. Изменение массива не меняет иерархию; сами TreeItem общие и сохраняют прежнего владельца.
GetCustomBgColorColor
public Color GetCustomBgColor(int column);Сохранённый локальный фон. При отсутствии настройки возвращает чёрный с alpha = 1, а не фон темы. Не сообщает режим justOutline и не позволяет отличить отсутствие настройки от явного чёрного.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
ColorСохранённый локальный фон. При отсутствии настройки возвращает чёрный с alpha = 1, а не фон темы. Не сообщает режим justOutline и не позволяет отличить отсутствие настройки от явного чёрного.
GetCustomColorColor
public Color GetCustomColor(int column);Локальный цвет текста; при отсутствии настройки возвращает чёрный с alpha = 1, а не фактический цвет темы. Явный чёрный и отсутствие настройки по этому getter не различить; при необходимости храните флаг переопределения в модели.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
ColorЛокальный цвет текста; при отсутствии настройки возвращает чёрный с alpha = 1, а не фактический цвет темы. Явный чёрный и отсутствие настройки по этому getter не различить; при необходимости храните флаг переопределения в модели.
GetCustomDrawCallbackCallable
public Callable GetCustomDrawCallback(int column);Сохранённый Callable отрисовки колонки, либо пустой Callable. Getter не выполняет отрисовку. Объект/делегат обработчика должен оставаться доступным, пока callback используется.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
CallableСохранённый Callable отрисовки колонки, либо пустой Callable. Getter не выполняет отрисовку. Объект/делегат обработчика должен оставаться доступным, пока callback используется.
GetCustomFontFont
public Font GetCustomFont(int column);Локальный ресурс Font либо null, если используется шрифт темы. Это не getter итогового шрифта и не копия ресурса.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
FontЛокальный ресурс Font либо null, если используется шрифт темы. Это не getter итогового шрифта и не копия ресурса.
GetCustomFontSizeint
public int GetCustomFontSize(int column);Сохранённый локальный размер, по умолчанию -1. Неположительное значение означает использование темы, а не отрицательный итоговый размер текста.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
intСохранённый локальный размер, по умолчанию -1. Неположительное значение означает использование темы, а не отрицательный итоговый размер текста.
GetCustomMinimumHeightint
public int GetCustomMinimumHeight();Дополнительный минимум высоты всей строки в пикселях, по умолчанию 0. Это не фиксированная высота: шрифт, иконки, кнопки и интервалы темы могут потребовать больше места. 0 снимает дополнительное требование.
intДополнительный минимум высоты всей строки в пикселях, по умолчанию 0. Это не фиксированная высота: шрифт, иконки, кнопки и интервалы темы могут потребовать больше места. 0 снимает дополнительное требование.
GetCustomStyleboxStyleBox
public StyleBox GetCustomStylebox(int column);Общий локальный StyleBox или null. Изменение этого ресурса влияет и на другие ячейки, использующие тот же объект.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
StyleBoxОбщий локальный StyleBox или null. Изменение этого ресурса влияет и на другие ячейки, использующие тот же объект.
GetDescriptionstring
public string GetDescription(int column);Сохранённое описание для доступности, независимо от видимого текста и подсказки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
stringСохранённое описание для доступности, независимо от видимого текста и подсказки.
GetExpandRightbool
public bool GetExpandRight(int column);Включено ли расширение в следующие пустые колонки. true — разрешение раскладки, а не подтверждение, что расширение произошло.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolВключено ли расширение в следующие пустые колонки. true — разрешение раскладки, а не подтверждение, что расширение произошло.
GetFirstChildTreeItem
public TreeItem GetFirstChild();Возвращает первого непосредственного ребёнка или null. Учитывает структурный порядок, а не свёрнутость или видимость строк.
TreeItemВозвращает первого непосредственного ребёнка или null. Учитывает структурный порядок, а не свёрнутость или видимость строк.
GetIconTexture2D
public Texture2D GetIcon(int column);Основная Texture2D ячейки или null. Возвращается общий ресурс с исходными размерами; визуальное ограничение IconMaxWidth не меняет текстуру.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Texture2DОсновная Texture2D ячейки или null. Возвращается общий ресурс с исходными размерами; визуальное ограничение IconMaxWidth не меняет текстуру.
GetIconMaxWidthint
public int GetIconMaxWidth(int column);Сохранённый локальный предел ширины. Это не итоговая ширина изображения: тема и доступное место могут ограничить отображение дополнительно.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
intСохранённый локальный предел ширины. Это не итоговая ширина изображения: тема и доступное место могут ограничить отображение дополнительно.
GetIconModulateColor
public Color GetIconModulate(int column);Сохранённый цветовой множитель иконки, не цвет отдельной кнопки действия.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
ColorСохранённый цветовой множитель иконки, не цвет отдельной кнопки действия.
GetIconOverlayTexture2D
public Texture2D GetIconOverlay(int column);Общий ресурс дополнительного слоя иконки или null. Это не самостоятельная кнопка действия.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Texture2DОбщий ресурс дополнительного слоя иконки или null. Это не самостоятельная кнопка действия.
GetIconRegionRect2
public Rect2 GetIconRegion(int column);Сохранённая область исходной текстуры, а не экранный прямоугольник. Пустой Rect2 означает всю текстуру.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Rect2Сохранённая область исходной текстуры, а не экранный прямоугольник. Пустой Rect2 означает всю текстуру.
GetIndexint
public int GetIndex();Текущая позиция среди непосредственных соседей с тем же родителем, начиная с 0. Меняется при вставке, удалении и перемещении соседей. Не используйте как постоянный ID записи модели.
intТекущая позиция среди непосредственных соседей с тем же родителем, начиная с 0. Меняется при вставке, удалении и перемещении соседей. Не используйте как постоянный ID записи модели.
GetLanguagestring
public string GetLanguage(int column);Сохранённая языковая подсказка или пустая строка для локали по умолчанию. Не возвращает переведённый текст.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
stringСохранённая языковая подсказка или пустая строка для локали по умолчанию. Не возвращает переведённый текст.
GetMetadataVariant
public Variant GetMetadata(int column);Возвращает Variant, сохранённый в ячейке. Освобождайте полученную C#-обёртку Variant после использования; это не удаляет строку.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
VariantВозвращает Variant, сохранённый в ячейке. Освобождайте полученную C#-обёртку Variant после использования; это не удаляет строку.
GetNextTreeItem
public TreeItem GetNext();Следующий непосредственный сосед с тем же родителем или null. Не переходит к дочерним строкам.
TreeItemСледующий непосредственный сосед с тем же родителем или null. Не переходит к дочерним строкам.
GetNextInTreeTreeItem
public TreeItem GetNextInTree(bool wrap = false);Следующая строка обхода в глубину: дети, затем соседи, затем выход к соседям предков. Учитывает скрытые и свёрнутые ветви. Без wrap конец — null; с wrap возвращается структурный корень, включая HideRoot. Для полного стабильного обхода начните с GetRoot и используйте wrap = false.
| Имя | Тип | По умолчанию |
|---|---|---|
wrap | bool | false |
wrapПродолжать с другой границы после конца. Учитывайте описанные особенности скрытого корня и обратного обхода.
TreeItemСледующая строка обхода в глубину: дети, затем соседи, затем выход к соседям предков. Учитывает скрытые и свёрнутые ветви. Без wrap конец — null; с wrap возвращается структурный корень, включая HideRoot. Для полного стабильного обхода начните с GetRoot и используйте wrap = false.
GetNextVisibleTreeItem
public TreeItem GetNextVisible(bool wrap = false);Следующая строка в глубину с пропуском свёрнутых ветвей и строк, для которых IsVisibleInTree = false. Это порядок строк, не проверка пикселей на экране. Ограничения: наследует ошибку кэша видимости; wrap может вернуть корень даже при HideRoot. Предпочитайте wrap = false и явно проверяйте родителей при фильтрации.
| Имя | Тип | По умолчанию |
|---|---|---|
wrap | bool | false |
wrapПродолжать с другой границы после конца. Учитывайте описанные особенности скрытого корня и обратного обхода.
TreeItemСледующая строка в глубину с пропуском свёрнутых ветвей и строк, для которых IsVisibleInTree = false. Это порядок строк, не проверка пикселей на экране. Ограничения: наследует ошибку кэша видимости; wrap может вернуть корень даже при HideRoot. Предпочитайте wrap = false и явно проверяйте родителей при фильтрации.
GetParentTreeItem
public TreeItem GetParent();Возвращает родительский TreeItem; null у корня и у отсоединённого корня поддерева.
TreeItemВозвращает родительский TreeItem; null у корня и у отсоединённого корня поддерева.
GetPrevTreeItem
public TreeItem GetPrev();Предыдущий непосредственный сосед с тем же родителем или null. Не выполняет обратный обход всех потомков.
TreeItemПредыдущий непосредственный сосед с тем же родителем или null. Не выполняет обратный обход всех потомков.
GetPrevInTreeTreeItem
public TreeItem GetPrevInTree(bool wrap = false);Предыдущая строка обратного обхода в глубину, включая свёрнутые и скрытые ветви. Есть особые границы: при HideRoot переход от первого ребёнка к корню возвращает null; wrap ищет последний элемент через видимый обход и может пропустить свёрнутые подветви. Для полного обратного обхода сохраните прямой обход GetNextInTree(false) и разверните список.
| Имя | Тип | По умолчанию |
|---|---|---|
wrap | bool | false |
wrapПродолжать с другой границы после конца. Учитывайте описанные особенности скрытого корня и обратного обхода.
TreeItemПредыдущая строка обратного обхода в глубину, включая свёрнутые и скрытые ветви. Есть особые границы: при HideRoot переход от первого ребёнка к корню возвращает null; wrap ищет последний элемент через видимый обход и может пропустить свёрнутые подветви. Для полного обратного обхода сохраните прямой обход GetNextInTree(false) и разверните список.
GetPrevVisibleTreeItem
public TreeItem GetPrevVisible(bool wrap = false);Предыдущая строка видимого обхода в глубину, не только сосед с тем же родителем. Пропускает свёрнутые подветви и строки с IsVisibleInTree = false. Без wrap на границе возвращает null. Не проверяет область прокрутки и наследует ограничение кэша родительской видимости.
| Имя | Тип | По умолчанию |
|---|---|---|
wrap | bool | false |
wrapПродолжать с другой границы после конца. Учитывайте описанные особенности скрытого корня и обратного обхода.
TreeItemПредыдущая строка видимого обхода в глубину, не только сосед с тем же родителем. Пропускает свёрнутые подветви и строки с IsVisibleInTree = false. Без wrap на границе возвращает null. Не проверяет область прокрутки и наследует ограничение кэша родительской видимости.
GetRangedouble
public double GetRange(int column);Сохранённое числовое значение. После SetRangeConfig может временно выходить за новые границы: конфигурация сама его не пересчитывает. Для повторного применения ограничений вызовите SetRange с текущим значением.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
doubleСохранённое числовое значение. После SetRangeConfig может временно выходить за новые границы: конфигурация сама его не пересчитывает. Для повторного применения ограничений вызовите SetRange с текущим значением.
GetRangeConfigReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary GetRangeConfig(int column);Новый Dictionary с min, max, step и expr; изменения словаря не меняют ячейку. Ограничение текущей реализации: expr всегда false, даже после SetRangeConfig(..., true). Экспоненциальную настройку храните в своей модели, не восстанавливайте её по этому ключу. Освобождайте C#-обёртку словаря после использования.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Reckfell.Collections.DictionaryНовый Dictionary с min, max, step и expr; изменения словаря не меняют ячейку. Ограничение текущей реализации: expr всегда false, даже после SetRangeConfig(..., true). Экспоненциальную настройку храните в своей модели, не восстанавливайте её по этому ключу. Освобождайте C#-обёртку словаря после использования.
GetStructuredTextBidiOverrideTextServer.StructuredTextParser
public TextServer.StructuredTextParser GetStructuredTextBidiOverride(int column);Сохранённый parser структурированного текста; Default использует обычный Unicode BiDi. Не возвращает направление каждой части строки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
TextServer.StructuredTextParserСохранённый parser структурированного текста; Default использует обычный Unicode BiDi. Не возвращает направление каждой части строки.
GetStructuredTextBidiOverrideOptionsReckfell.Collections.Array
public Reckfell.Collections.Array GetStructuredTextBidiOverrideOptions(int column);Обёртка общего массива параметров BiDi-parser. Изменение содержимого меняет сохранённые параметры, но само не запускает пересчёт текста. Для новой конфигурации подготовьте отдельный массив и вызовите setter. Освобождайте C#-обёртку Array после использования.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Reckfell.Collections.ArrayОбёртка общего массива параметров BiDi-parser. Изменение содержимого меняет сохранённые параметры, но само не запускает пересчёт текста. Для новой конфигурации подготовьте отдельный массив и вызовите setter. Освобождайте C#-обёртку Array после использования.
GetSuffixstring
public string GetSuffix(int column);Сохранённый суффикс, отдельно от исходного GetText и числового GetRange. Смена CellMode его не сбрасывает.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
stringСохранённый суффикс, отдельно от исходного GetText и числового GetRange. Смена CellMode его не сбрасывает.
GetTextstring
public string GetText(int column);Возвращает исходную строку SetText, а не автоматически переведённое отображение и не идентификатор модели.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
stringВозвращает исходную строку SetText, а не автоматически переведённое отображение и не идентификатор модели.
GetTextAlignmentHorizontalAlignment
public HorizontalAlignment GetTextAlignment(int column);Сохранённое горизонтальное выравнивание текста ячейки, не направление текста и не координата колонки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
HorizontalAlignmentСохранённое горизонтальное выравнивание текста ячейки, не направление текста и не координата колонки.
GetTextDirectionControl.TextDirection
public Control.TextDirection GetTextDirection(int column);Сохранённое базовое направление письма. Inherited означает наследование от Tree, а не уже вычисленное LTR/RTL.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
Control.TextDirectionСохранённое базовое направление письма. Inherited означает наследование от Tree, а не уже вычисленное LTR/RTL.
GetTextOverrunBehaviorTextServer.OverrunBehavior
public TextServer.OverrunBehavior GetTextOverrunBehavior(int column);Сохранённое правило обрезки текста. Не возвращает уже обрезанную строку и не проверяет фактическое переполнение.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
TextServer.OverrunBehaviorСохранённое правило обрезки текста. Не возвращает уже обрезанную строку и не проверяет фактическое переполнение.
GetTooltipTextstring
public string GetTooltipText(int column);Сохранённая явная подсказка ячейки. Не вычисляет автоматическую подсказку из подписи и не возвращает подсказку отдельной кнопки действия.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
stringСохранённая явная подсказка ячейки. Не вычисляет автоматическую подсказку из подписи и не возвращает подсказку отдельной кнопки действия.
GetTreeTree
public Tree GetTree();Возвращает UI-контрол Tree, которому принадлежит строка, либо null у отсоединённого поддерева. Это не EntityTree.
TreeВозвращает UI-контрол Tree, которому принадлежит строка, либо null у отсоединённого поддерева. Это не EntityTree.
IsAcceptingChildrenbool
public bool IsAcceptingChildren();Сохранённая политика приёма детей для drag-and-drop. false не означает, что у строки нет детей или что CreateChild запрещён.
boolСохранённая политика приёма детей для drag-and-drop. false не означает, что у строки нет детей или что CreateChild запрещён.
IsAnyCollapsedbool
public bool IsAnyCollapsed(bool onlyVisible = false);Есть ли свёрнутая ветвь среди этой строки и её потомков. Свёрнутый лист без детей не считается. onlyVisible ограничивает проверку по флагам видимости и наличию видимых детей; это не проверка попадания строк в область прокрутки. Учитывайте ограничение кэша IsVisibleInTree.
| Имя | Тип | По умолчанию |
|---|---|---|
onlyVisible | bool | false |
onlyVisibleОграничить поиск по видимости ветвей; не означает видимость в области прокрутки.
boolЕсть ли свёрнутая ветвь среди этой строки и её потомков. Свёрнутый лист без детей не считается. onlyVisible ограничивает проверку по флагам видимости и наличию видимых детей; это не проверка попадания строк в область прокрутки. Учитывайте ограничение кэша IsVisibleInTree.
IsButtonDisabledbool
public bool IsButtonDisabled(int column, int buttonIndex);Отключена ли кнопка по неотрицательному индексу. Не принимает ID команды или отрицательный индекс от конца.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexНеотрицательный индекс кнопки в колонке, не ID команды.
boolОтключена ли кнопка по неотрицательному индексу. Не принимает ID команды или отрицательный индекс от конца.
IsCheckedbool
public bool IsChecked(int column);Сохранённое булево состояние флажка. Смешанное состояние проверяйте отдельно через IsIndeterminate; это не список выбранных строк Tree.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolСохранённое булево состояние флажка. Смешанное состояние проверяйте отдельно через IsIndeterminate; это не список выбранных строк Tree.
IsCollapsedbool
public bool IsCollapsed();Свёрнута ли ветвь; по умолчанию false. Строка остаётся, скрываются её потомки при видимом обходе и отображении. Изменение у присоединённой строки испускает Tree.ItemCollapsed; повторное значение и setter у отсоединённой строки ничего не делают. Если курсор внутри ветви, он может переместиться на эту строку.
boolСвёрнута ли ветвь; по умолчанию false. Строка остаётся, скрываются её потомки при видимом обходе и отображении. Изменение у присоединённой строки испускает Tree.ItemCollapsed; повторное значение и setter у отсоединённой строки ничего не делают. Если курсор внутри ветви, он может переместиться на эту строку.
IsCustomSetAsButtonbool
public bool IsCustomSetAsButton(int column);Сохранённый флаг кнопочного оформления Custom. true не означает наличие отдельной кнопки AddButton или активный режим Custom.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolСохранённый флаг кнопочного оформления Custom. true не означает наличие отдельной кнопки AddButton или активный режим Custom.
IsEditMultilinebool
public bool IsEditMultiline(int column);Настроено ли многострочное редактирование String. По умолчанию false; флаг не означает, что редактор сейчас открыт.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolНастроено ли многострочное редактирование String. По умолчанию false; флаг не означает, что редактор сейчас открыт.
IsEditablebool
public bool IsEditable(int column);Разрешено ли пользовательское редактирование. Программные setters работают независимо от этого флага.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolРазрешено ли пользовательское редактирование. Программные setters работают независимо от этого флага.
IsFoldingDisabledbool
public bool IsFoldingDisabled();Убирает обычный элемент сворачивания этой строки. Не раскрывает уже свёрнутую ветвь и не запрещает программный Collapsed или SetCollapsedRecursive. Для принудительно раскрытой ветви отдельно задайте Collapsed = false.
boolУбирает обычный элемент сворачивания этой строки. Не раскрывает уже свёрнутую ветвь и не запрещает программный Collapsed или SetCollapsedRecursive. Для принудительно раскрытой ветви отдельно задайте Collapsed = false.
IsIndeterminatebool
public bool IsIndeterminate(int column);Ячейка находится в смешанном состоянии. Оно хранится отдельно от checked; считывайте оба признака, если модель различает включено, выключено и частично включено.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolЯчейка находится в смешанном состоянии. Оно хранится отдельно от checked; считывайте оба признака, если модель различает включено, выключено и частично включено.
IsSelectablebool
public bool IsSelectable(int column);Можно ли выбирать ячейку. Это отдельное свойство от сохранённого флага выбора; изменение не очищает этот флаг.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
boolМожно ли выбирать ячейку. Это отдельное свойство от сохранённого флага выбора; изменение не очищает этот флаг.
IsSelectedbool
public bool IsSelected(int column);true только если ячейка доступна для выбора и её внутренний флаг установлен. При Selectable = false возвращает false, даже если GetNextSelected ещё находит строку по сохранённому флагу.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
booltrue только если ячейка доступна для выбора и её внутренний флаг установлен. При Selectable = false возвращает false, даже если GetNextSelected ещё находит строку по сохранённому флагу.
IsVisiblebool
public bool IsVisible();Собственный флаг показа строки, true по умолчанию. false не удаляет строку и не меняет Visible её потомков. Скрытие снимает флаги выбора самой строки, но не является полным сбросом выбора всех потомков. Для надёжного фильтра ветви отдельно определите правила очистки выбора.
boolСобственный флаг показа строки, true по умолчанию. false не удаляет строку и не меняет Visible её потомков. Скрытие снимает флаги выбора самой строки, но не является полным сбросом выбора всех потомков. Для надёжного фильтра ветви отдельно определите правила очистки выбора.
IsVisibleInTreebool
public bool IsVisibleInTree();Возвращает Visible строки с учётом внутреннего кэша родительской видимости. Не учитывает Collapsed предков, HideRoot, прокрутку или видимость самого UI-контрола. Ограничение: hide/show более высокого предка может сделать результат true под промежуточным Visible = false. Когда важен точный результат, пройдите GetParent и проверьте IsVisible у каждого предка; свёрнутость и скрытый корень проверяйте отдельно.
boolВозвращает Visible строки с учётом внутреннего кэша родительской видимости. Не учитывает Collapsed предков, HideRoot, прокрутку или видимость самого UI-контрола. Ограничение: hide/show более высокого предка может сделать результат true под промежуточным Visible = false. Когда важен точный результат, пройдите GetParent и проверьте IsVisible у каждого предка; свёрнутость и скрытый корень проверяйте отдельно.
MoveAftervoid
public void MoveAfter(TreeItem item);Перемещает существующую строку вместе с поддеревом после item. item должен иметь родителя; корень перемещать нельзя. Не переносите строку внутрь собственного поддерева. При смене Tree учитывайте потерю лишних колонок.
| Имя | Тип | По умолчанию |
|---|---|---|
item | TreeItem | — |
itemСтрока, перед которой или после которой нужно вставить текущую; должна иметь родителя.
MoveBeforevoid
public void MoveBefore(TreeItem item);Перемещает существующую строку вместе с поддеревом перед item. item должен иметь родителя; корень перемещать нельзя. Не переносите строку внутрь собственного поддерева. При смене Tree учитывайте потерю лишних колонок.
| Имя | Тип | По умолчанию |
|---|---|---|
item | TreeItem | — |
itemСтрока, перед которой или после которой нужно вставить текущую; должна иметь родителя.
PropagateCheckvoid
public void PropagateCheck(int column, bool emitSignal = true);Копирует текущий checked этой строки всем потомкам в колонке, затем пересчитывает родителей: все включённые дети дают checked = true, все выключенные — false, смешанные — indeterminate. Не учитывает Editable или Selectable и не вызывает ItemEdited. Требует действительную колонку и присоединённую к Tree строку. При emitSignal уведомляет саму строку, потомков в глубину, затем родителей снизу вверх — даже без изменения значения. При равном checked у потомка его indeterminate может сохраниться; это не принудительный сброс всех mixed-флагов.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
emitSignal | bool | true |
columnИндекс колонки от 0 до Tree.Columns - 1.
emitSignalИспускать CheckPropagatedToItem для каждой посещённой строки; false меняет данные без этих уведомлений.
RemoveChildvoid
public void RemoveChild(TreeItem child);Отсоединяет непосредственного ребёнка вместе с потомками, не удаляя их. Их GetTree становится null. Вызывающий код обязан заново присоединить поддерево или освободить через Free.
| Имя | Тип | По умолчанию |
|---|---|---|
child | TreeItem | — |
childПоддерево: для AddChild — отсоединённое, для RemoveChild — непосредственный ребёнок этой строки.
Select2 перегрузки
public void Select(int column);Выбирает ячейку: в Single заменяет выбор, в Row выбирает доступные ячейки строки, в Multi добавляет флаг без CellSelected/ItemSelected/MultiSelected. setAsCursor влияет только на Multi; false сохраняет прежний курсор. Перегрузка без bool использует true. Обновляйте модель явно после программного накопления выбора.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
public void Select(int column, bool setAsCursor = true);Выбирает ячейку: в Single заменяет выбор, в Row выбирает доступные ячейки строки, в Multi добавляет флаг без CellSelected/ItemSelected/MultiSelected. setAsCursor влияет только на Multi; false сохраняет прежний курсор. Перегрузка без bool использует true. Обновляйте модель явно после программного накопления выбора.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
setAsCursor | bool | true |
columnИндекс колонки от 0 до Tree.Columns - 1.
setAsCursorТолько для Multi: true также перемещает курсор, false меняет флаг без перемещения курсора.
SetAcceptChildrenvoid
public void SetAcceptChildren(bool allowed);Управляет приёмом дочерних элементов при расчёте области drag-and-drop. Не запрещает CreateChild/AddChild из кода и не проверяет бизнес-правила переноса. Проверяйте модель в собственном обработчике перетаскивания.
| Имя | Тип | По умолчанию |
|---|---|---|
allowed | bool | — |
allowedРазрешить строке принимать детей как цель drag-and-drop.
SetAutoTranslateModevoid
public void SetAutoTranslateMode(int column, Entity.AutoTranslateModeEnum mode);Задаёт политику перевода подписи ячейки: Inherit следует настройке Tree, Always использует перевод, Disabled оставляет исходный текст. Не меняет GetText и не добавляет переводы в каталог. Редактируемый String не переводится автоматически даже при Always, чтобы не подменять пользовательский ввод.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
mode | Entity.AutoTranslateModeEnum | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
modeПолитика перевода подписи Inherit, Always или Disabled; не изменяет исходный текст.
SetAutowrapModevoid
public void SetAutowrapMode(int column, TextServer.AutowrapMode autowrapMode);Задаёт перенос текста по доступной ширине: Off, Arbitrary, Word или WordSmart. Не задаёт ширину колонки и не включает многострочное редактирование. Сначала настройте размеры колонок; редактирование через SetEditMultiline — отдельная настройка.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
autowrapMode | TextServer.AutowrapMode | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
autowrapModeРежим переноса текста внутри доступной ширины ячейки.
SetAutowrapTrimFlagsvoid
public void SetAutowrapTrimFlags(int column, TextServer.LineBreakFlag flags);Задаёт обработку пробелов на границах строк. Сохраняет только TrimIndent, TrimStartEdgeSpaces и TrimEndEdgeSpaces; флаги Mandatory, WordBound и другие отбрасывает. Места переноса задавайте через SetAutowrapMode.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
flags | TextServer.LineBreakFlag | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
flagsTrimIndent и/или TrimStartEdgeSpaces/TrimEndEdgeSpaces. Остальные биты отбрасываются.
SetButtonvoid
public void SetButton(int column, int buttonIndex, Texture2D button);Заменяет текстуру существующей кнопки, сохраняя ID и остальные настройки. button не должен быть null. Отрицательный buttonIndex отсчитывается с конца: -1 — последняя кнопка.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
button | Texture2D | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexИндекс, не ID команды; у этого setter отрицательные значения отсчитываются с конца.
buttonНепустая Texture2D кнопки; сохраняется по ссылке.
SetButtonColorvoid
public void SetButtonColor(int column, int buttonIndex, Color color);Задаёт цветовой множитель текстуры кнопки, включая alpha. buttonIndex — индекс, отрицательный отсчитывается с конца. Не меняет цвет основной иконки строки и не активирует кнопку.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
color | Color | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexИндекс, не ID команды; у этого setter отрицательные значения отсчитываются с конца.
colorЦветовой множитель текстуры кнопки с alpha.
SetButtonDescriptionvoid
public void SetButtonDescription(int column, int buttonIndex, string description);Задаёт описание действия для доступности; это отдельный текст от подсказки. buttonIndex допускает отрицательный индекс от конца. Не меняет ID команды или подпись основной ячейки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
description | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexИндекс, не ID команды; у этого setter отрицательные значения отсчитываются с конца.
descriptionОписание действия для средств доступности, отдельно от подсказки.
SetButtonDisabledvoid
public void SetButtonDisabled(int column, int buttonIndex, bool disabled);Отключает пользовательскую активацию отдельной кнопки, не удаляя её и не отключая строку целиком. buttonIndex допускает отрицательный индекс от конца. Это UI-политика, не проверка прав выполнения команды.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
disabled | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexИндекс, не ID команды; у этого setter отрицательные значения отсчитываются с конца.
disabledЗапретить пользовательскую активацию этой кнопки.
SetButtonTooltipTextvoid
public void SetButtonTooltipText(int column, int buttonIndex, string tooltip);Меняет подсказку кнопки. buttonIndex — индекс, в том числе отрицательный от конца; пустая строка очищает подсказку.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
buttonIndex | int | — |
tooltip | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
buttonIndexИндекс, не ID команды; у этого setter отрицательные значения отсчитываются с конца.
tooltipНовый текст подсказки или пустая строка для очистки.
SetCellModevoid
public void SetCellMode(int column, TreeItem.TreeCellMode mode);Задаёт вид ячейки. При смене режима сбрасывает текст, основную иконку, checked, числовое значение и диапазон (0…100, шаг 1); Metadata и indeterminate сохраняются. Повторная установка того же режима ничего не сбрасывает. Сначала задайте режим, затем заполните данные.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
mode | TreeItem.TreeCellMode | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
modeРежим отображения ячейки. Смена режима сбрасывает часть данных; назначайте его до заполнения.
SetCheckedvoid
public void SetChecked(int column, bool @checked);Задаёт булево состояние без ItemEdited и без распространения по иерархии. Если значение изменилось, сбрасывает indeterminate; при равном значении mixed-флаг сохраняется. Для иерархического флажка после изменения явно вызовите PropagateCheck.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
checked | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
checkedБулево состояние. Равное значение не очищает indeterminate.
SetCollapsedvoid
public void SetCollapsed(bool enable);Свёрнута ли ветвь; по умолчанию false. Строка остаётся, скрываются её потомки при видимом обходе и отображении. Изменение у присоединённой строки испускает Tree.ItemCollapsed; повторное значение и setter у отсоединённой строки ничего не делают. Если курсор внутри ветви, он может переместиться на эту строку.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableСвернуть при true, раскрыть при false.
SetCollapsedRecursivevoid
public void SetCollapsedRecursive(bool enable);Применяет Collapsed к этой строке и всем потомкам, включая листья и скрытые строки. Каждая реально изменённая присоединённая строка испускает ItemCollapsed. Это множество отдельных изменений, а не одно итоговое уведомление; не удаляйте строки из обработчика обхода.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableСвернуть при true, раскрыть при false.
SetCustomAsButtonvoid
public void SetCustomAsButton(int column, bool enable);Включает оформление ячейки Custom как кнопки. Не меняет CellMode, не добавляет запись AddButton и не включает Editable. Настраивайте режим Custom и правила редактирования отдельно.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
enable | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
enableКнопочное оформление Custom без изменения CellMode или Editable.
SetCustomBgColorvoid
public void SetCustomBgColor(int column, Color color, bool justOutline = false);Задаёт дополнительный локальный фон ячейки. justOutline = true рисует только контур, false — заливку. Не меняет цвет текста и не заменяет настройки всей темы. Для удаления используйте ClearCustomBgColor.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
color | Color | — |
justOutline | bool | false |
columnИндекс колонки от 0 до Tree.Columns - 1.
colorЛокальный цвет с alpha; сброс к теме выполняется отдельным Clear-методом.
justOutlinetrue — контур, false — заливка фона.
SetCustomColorvoid
public void SetCustomColor(int column, Color color);Задаёт локальный цвет текста ячейки, включая alpha, вместо цвета текста темы. Не перекрашивает иконку или всю тему. Для возврата к теме вызовите ClearCustomColor, а не передавайте предполагаемый цвет по умолчанию.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
color | Color | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
colorЛокальный цвет с alpha; сброс к теме выполняется отдельным Clear-методом.
SetCustomDrawvoid · Устарело
public void SetCustomDraw(int column, ReckfellObject @object, StringName callback);Устаревшая привязка отрисовки через объект и имя метода. Вместо неё используйте SetCustomDrawCallback с Callable; существующий callback получает TreeItem и Rect2. Не вызывайте этот метод в новом коде.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
object | ReckfellObject | — |
callback | StringName | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
objectОбъект старого обработчика; для нового кода используйте Callable.
callbackИмя метода старого обработчика; переходите на SetCustomDrawCallback.
SetCustomDrawCallbackvoid
public void SetCustomDrawCallback(int column, Callable callback);Назначает Callable для отрисовки ячейки Custom. Callback получает TreeItem и Rect2 области в координатах рисования Tree; используйте Tree.GetCustomDrawingCanvasItem для команд рисования. Назначение не меняет CellMode и не вызывает callback сразу. default(Callable) очищает его. Не удаляйте строки и не перестраивайте иерархию внутри отрисовки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
callback | Callable | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
callbackCallable с аргументами TreeItem и Rect2; default очищает callback.
SetCustomFontvoid
public void SetCustomFont(int column, Font font);Задаёт общий ресурс Font для текста этой ячейки. null возвращает шрифт темы. Размер задаётся отдельно через SetCustomFontSize; изменение общего ресурса влияет на всех, кто его использует.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
font | Font | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
fontОбщий Font или null для использования шрифта темы.
SetCustomFontSizevoid
public void SetCustomFontSize(int column, int fontSize);Локальный размер текста в пикселях. Положительное значение переопределяет размер темы; 0 и отрицательные возвращают размер темы. Сам ресурс Font и размеры текста в других ячейках не меняются.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
fontSize | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
fontSizeПоложительный локальный размер в пикселях; 0 или меньше — размер темы.
SetCustomMinimumHeightvoid
public void SetCustomMinimumHeight(int height);Дополнительный минимум высоты всей строки в пикселях, по умолчанию 0. Это не фиксированная высота: шрифт, иконки, кнопки и интервалы темы могут потребовать больше места. 0 снимает дополнительное требование.
| Имя | Тип | По умолчанию |
|---|---|---|
height | int | — |
heightНеотрицательный дополнительный минимум высоты строки в пикселях; 0 убирает его.
SetCustomStyleboxvoid
public void SetCustomStylebox(int column, StyleBox stylebox);Задаёт общий StyleBox, рисуемый в области ячейки. null убирает локальный StyleBox. Не назначает тему всему Tree и не заменяет текст или кнопки действий.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
stylebox | StyleBox | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
styleboxОбщий StyleBox или null для удаления локального оформления.
SetDescriptionvoid
public void SetDescription(int column, string description);Задаёт описание ячейки для доступности. Не заменяет видимую подпись или подсказку; для них используйте SetText и SetTooltipText.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
description | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
descriptionОписание для доступности, не видимая подпись.
SetDisableFoldingvoid
public void SetDisableFolding(bool disable);Убирает обычный элемент сворачивания этой строки. Не раскрывает уже свёрнутую ветвь и не запрещает программный Collapsed или SetCollapsedRecursive. Для принудительно раскрытой ветви отдельно задайте Collapsed = false.
| Имя | Тип | По умолчанию |
|---|---|---|
disable | bool | — |
disableУбрать обычное управление сворачиванием; программный Collapsed продолжает работать.
SetEditMultilinevoid
public void SetEditMultiline(int column, bool multiline);Выбирает многострочное редактирование текста String вместо однострочного. Не меняет текст и не включает Editable. Не превращает Range или Check в многострочный редактор.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
multiline | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
multilineИспользовать многострочный редактор для String; Editable задаётся отдельно.
SetEditablevoid
public void SetEditable(int column, bool enabled);Разрешает пользовательское редактирование ячейки; по умолчанию false. Не запрещает программные SetText, SetChecked, SetRange или PropagateCheck и не включает выбор строки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
enabled | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
enabledРазрешить пользовательское редактирование, не ограничивая программные setters.
SetExpandRightvoid
public void SetExpandRight(int column, bool enable);Разрешает содержимому занять пространство следующих пустых ячеек String без иконки и редактирования. Не объединяет данные колонок и не меняет Tree.Columns. Заполненная или редактируемая соседняя ячейка останавливает расширение.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
enable | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
enableРазрешить расширение в следующие пустые ячейки.
SetIconvoid
public void SetIcon(int column, Texture2D texture);Задаёт основную иконку ячейки как общий ресурс Texture2D. null убирает её, не удаляя кнопки действий или текст. Ограничение ширины и область текстуры задаются отдельно.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
texture | Texture2D | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
textureОбщая Texture2D; null очищает соответствующую иконку или слой.
SetIconMaxWidthvoid
public void SetIconMaxWidth(int column, int width);Локальное ограничение ширины иконки. Положительное значение уменьшает широкую иконку с сохранением пропорций; увеличение не выполняется. Применяется более строгое из положительных ограничений ячейки и темы icon_max_width. Неположительное значение отключает только локальный предел.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
width | int | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
widthПоложительный предел ширины; 0 или меньше отключает локальный предел.
SetIconModulatevoid
public void SetIconModulate(int column, Color modulate);Задаёт цветовой множитель основной иконки и её слоя, включая alpha. Не меняет ресурс Texture2D и цвет кнопок действий.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
modulate | Color | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
modulateЦветовой множитель основной иконки и её слоя.
SetIconOverlayvoid
public void SetIconOverlay(int column, Texture2D texture);Задаёт дополнительную текстуру поверх основной иконки; null очищает слой. Без основной иконки слой отдельно не рисуется. Для независимой кнопки используйте AddButton.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
texture | Texture2D | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
textureОбщая Texture2D; null очищает соответствующую иконку или слой.
SetIconRegionvoid
public void SetIconRegion(int column, Rect2 region);Задаёт область исходной текстуры основной иконки в пикселях. Пустой Rect2 выбирает всю текстуру. Область влияет на исходные размеры иконки перед ограничением ширины; сам ресурс не обрезается и не копируется.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
region | Rect2 | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
regionОбласть исходной текстуры в пикселях; пустой Rect2 выбирает всю текстуру.
SetIndeterminatevoid
public void SetIndeterminate(int column, bool indeterminate);Задаёт смешанное состояние. При изменении indeterminate сбрасывает checked в false; повторное равное значение ничего не меняет. Не пересчитывает потомков или родителей и не испускает ItemEdited.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
indeterminate | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
indeterminateСмешанное состояние; его изменение сбрасывает checked.
SetLanguagevoid
public void SetLanguage(int column, string language);Задаёт языковую подсказку для формирования текста, например ar. Не переводит подпись и не переключает язык приложения. Пустая строка использует текущую локаль при формировании текста.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
language | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
languageЯзыковая подсказка формирования текста; пустая строка — текущая локаль.
SetMetadatavoid
public void SetMetadata(int column, Variant meta);Сохраняет Variant в ячейке без ItemEdited. Используйте стабильный ключ модели. Массивы, словари и ресурсы не становятся глубокими копиями при сохранении.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
meta | Variant | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
metaЗначение Variant, например стабильный идентификатор записи модели.
SetRangevoid
public void SetRange(int column, double value);Задаёт число без ItemEdited: при step > 0 округляет к кратному шагу относительно 0, затем ограничивает min/max. Граница может оказаться не кратна шагу. При вариантах из SetText проверяется только диапазон, а не наличие такого идентификатора в списке.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
value | double | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
valueНовое число; будет округлено по положительному шагу и ограничено границами.
SetRangeConfigvoid
public void SetRangeConfig(int column, double min, double max, double step, bool expr = false);Задаёт min, max, step и экспоненциальный режим редактирования. Используйте корректные границы min <= max; текущий GetRange не пересчитывается. Для числовой ячейки сначала Range, затем конфигурация и SetRange. В Range непустой SetText задаёт варианты и заменяет min/max/step.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
min | double | — |
max | double | — |
step | double | — |
expr | bool | false |
columnИндекс колонки от 0 до Tree.Columns - 1.
minНижняя граница, не выше max.
maxВерхняя граница, не ниже min.
stepПоложительный шаг округления; 0 отключает округление.
exprЭкспоненциальное редактирование. GetRangeConfig не возвращает этот флаг достоверно; храните настройку отдельно.
SetSelectablevoid
public void SetSelectable(int column, bool selectable);Разрешает выбор ячейки, но не очищает сохранённый флаг и не испускает сигналы выбора. false делает IsSelected ложным; после возврата true старый выбор снова виден. Чтобы удалить выбор окончательно, вызовите Deselect перед отключением.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
selectable | bool | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
selectableРазрешить выбор ячейки. false маскирует прежний флаг, а не очищает его.
SetStructuredTextBidiOverridevoid
public void SetStructuredTextBidiOverride(int column, TextServer.StructuredTextParser parser);Выбирает BiDi-разбор структурированной подписи: например URI, путь, адрес почты или список. Это помогает сохранять смысл разделителей при смешанном LTR/RTL, а не переводит текст. Параметры выбранного parser задайте отдельно.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
parser | TextServer.StructuredTextParser | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
parserParser структурированной строки, выбранный по типу содержимого.
SetStructuredTextBidiOverrideOptionsvoid
public void SetStructuredTextBidiOverrideOptions(int column, Reckfell.Collections.Array args);Задаёт параметры выбранного BiDi-parser как общий Array, не глубокую копию. После установки не меняйте переданный массив на месте: это не уведомляет кэш текста. Передавайте заранее подготовленный отдельный массив; при изменении — новый массив с новым содержимым. Равное содержимое пропускается setter’ом, поэтому простая передача Duplicate с прежними значениями не отсоединяет старый контейнер.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
args | Reckfell.Collections.Array | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
argsОбщий массив параметров BiDi-parser. Не изменяйте на месте после назначения.
SetSuffixvoid
public void SetSuffix(int column, string text);Задаёт буквальный суффикс отображаемого значения. При непустой подписи добавляется после пробела; GetText не меняется. Суффикс не переводится автоматически вместе с подписью — передавайте уже локализованную строку.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
text | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
textБуквальный, уже локализованный суффикс или пустая строка для его удаления.
SetTextvoid
public void SetText(int column, string text);Задаёт исходный текст ячейки без ItemEdited. В режиме Range строка задаёт варианты через запятую, с необязательным числом после двоеточия: label:value; это не обычная подпись.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
text | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
textИсходный текст; в режиме Range — спецификация вариантов через запятую.
SetTextAlignmentvoid
public void SetTextAlignment(int column, HorizontalAlignment textAlignment);Выравнивает текст внутри доступной области ячейки. Не меняет порядок колонок, структуру строк или направление текста; направление задаётся через SetTextDirection.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
textAlignment | HorizontalAlignment | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
textAlignmentГоризонтальное выравнивание текста внутри ячейки.
SetTextDirectionvoid
public void SetTextDirection(int column, Control.TextDirection direction);Задаёт базовое направление письма, не меняя исходную последовательность GetText. Inherited следует направлению раскладки Tree. Это не горизонтальное выравнивание и не перевод; для выравнивания используйте SetTextAlignment.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
direction | Control.TextDirection | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
directionБазовое направление письма; Inherited использует раскладку Tree.
SetTextOverrunBehaviorvoid
public void SetTextOverrunBehavior(int column, TextServer.OverrunBehavior overrunBehavior);Задаёт обрезку текста и многоточие при нехватке доступного места. Не меняет исходный GetText и не расширяет колонку. NoTrimming отключает обрезку, но не гарантирует, что длинный текст поместится в интерфейсе.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
overrunBehavior | TextServer.OverrunBehavior | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
overrunBehaviorПравило обрезки текста и добавления многоточия.
SetTooltipTextvoid
public void SetTooltipText(int column, string tooltip);Задаёт собственную подсказку ячейки, отдельно от текста и описания для доступности. Пустая строка очищает только явную подсказку: при Tree.AutoTooltip = true вместо неё может показываться подпись/значение ячейки.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
tooltip | string | — |
columnИндекс колонки от 0 до Tree.Columns - 1.
tooltipЯвная подсказка; пустая строка допускает автоматическую подстановку при AutoTooltip.
SetVisiblevoid
public void SetVisible(bool enable);Собственный флаг показа строки, true по умолчанию. false не удаляет строку и не меняет Visible её потомков. Скрытие снимает флаги выбора самой строки, но не является полным сбросом выбора всех потомков. Для надёжного фильтра ветви отдельно определите правила очистки выбора.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableСобственный флаг показа строки, без удаления и без изменения Visible потомков.
UncollapseTreevoid
public void UncollapseTree();Раскрывает эту строку и цепочку её родителей до корня. Не раскрывает соседние ветви, не включает Visible и не прокручивает список к строке. Может испускать ItemCollapsed для каждого изменённого предка и самой строки.
TreeItem.TreeCellMode
| Значение | Описание |
|---|---|
Check = 1 | Ячейка показывает флажок, опционально с текстом и значком. Флажок можно нажать, отпустить или сделать неопределенным (через |
Custom = 4 | Ячейка отображается как нажимаемая кнопка. Она будет отображать стрелку, похожую на |
Icon = 3 | Ячейка показывает значок. Его нельзя редактировать или отображать текст. Значок всегда находится в центре ячейки. |
Range = 2 | Ячейка показывает числовой диапазон. Если он доступен для редактирования, его можно редактировать с помощью ползунка диапазона. Используйте |
String = 0 | Ячейка показывает строковую метку, опционально со значком. Если текст редактируемый, его можно редактировать с помощью |