ItemList

public ItemList();

Создаёт пустой список: Single, без выбора, AllowReselect/AllowRmbSelect выключены, AllowSearch включён.

public bool AllowReselect { get; set; }

Разрешает повторное уведомление пользовательского одиночного выбора, false по умолчанию. Не заставляет прямой Select испускать ItemSelected.

public bool AllowRmbSelect { get; set; }

Разрешает выбор правой кнопкой, false по умолчанию. Не создаёт контекстное меню и не ограничивает программный Select.

public bool AllowSearch { get; set; }

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

public bool AutoHeight { get; set; }

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

public bool AutoWidth { get; set; }

Использовать ширину содержимого как минимальную ширину Control, false по умолчанию. После пересчёта может расширить родительский контейнер и отключает обычную подгонку колонок по ширине. Для ограниченного списка оставьте false.

public int FixedColumnWidth { get; set; }

Заданная ширина колонки/текста в локальных пикселях, 0 по умолчанию — по содержимому. Требуется ≥ 0. Для переноса текста используйте положительную ширину вместе с IconMode.Top и MaxTextLines; межэлементные поля темы добавляются отдельно.

public Vector2I FixedIconSize { get; set; }

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

public ItemList.IconModeEnum IconMode { get; set; }

Основная иконка Left по умолчанию или Top. Top допускает подпись с переносом при ограниченной ширине; не меняет исходный текст или пиксели иконки.

public float IconScale { get; set; }

Множитель размеров иконок и их места в раскладке, 1 по умолчанию. Требуется конечное число; используйте положительное значение для обычного показа. Масштабирует и FixedIconSize, не изменяя Texture2D.

public int ItemCount { get; set; }

Число записей, 0 по умолчанию. Setter требует ≥ 0: новые записи пустые, selectable и не выбранные; уменьшение отбрасывает хвост без сигналов выбора. После структурной смены сбросьте/восстановите выбор явно.

public int MaxColumns { get; set; }

Верхняя граница числа колонок, 1 по умолчанию. 0 означает без заданного предела, а не ноль колонок. При переносе доступная ширина может уменьшить фактическое число. Требуется ≥ 0.

public int MaxTextLines { get; set; }

Максимальное число строк подписи, 1 по умолчанию; требуется ≥ 1. Перенос применяется в IconMode.Top и требует ограниченной ширины, например FixedColumnWidth. В Left увеличение не включает многострочное размещение.

public bool SameColumnWidth { get; set; }

Выравнивает ширины по самому широкому элементу, false по умолчанию. Не задаёт фиксированное число колонок и не ограничивает ширину текста само по себе.

public ItemList.ScrollHintModeEnum ScrollHintMode { get; set; }

Декоративная подсказка вертикальной прокрутки: Disabled по умолчанию, Both/Top/Bottom. Использует scroll_hint темы и текущий диапазон, не включает прокрутку и не заменяет ScrollBar.

public ItemList.SelectModeEnum SelectMode { get; set; }

Режим Single по умолчанию, Multi или Toggle. Toggle переключает выбор кликом без Ctrl. Setter сам не нормализует уже выставленные флаги выбора; для Multi/Toggle → Single сначала вызовите DeselectAll и восстановите нужную запись.

public TextServer.OverrunBehavior TextOverrunBehavior { get; set; }

Обрезка/многоточие текста при ограниченной ширине, TrimEllipsis по умолчанию. Само свойство не задаёт ширину и не включает перенос строк; согласуйте с FixedColumnWidth, MaxTextLines и IconMode.

public bool TileScrollHint { get; set; }

Повторять текстуру scroll_hint вместо растягивания, false по умолчанию. Имеет смысл при включённом ScrollHintMode и доступном содержимом выше/ниже.

public bool WraparoundItems { get; set; }

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

public int AddIconItem(Texture2D icon, bool selectable = true);

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

public int AddItem(string text, Texture2D icon = null, bool selectable = true);

Добавляет текст, необязательную общую иконку и флаг selectable; возвращает новый индекс. Выбор автоматически не меняет и ItemSelected не испускает.

public void CenterOnCurrent(bool centerVerically = true, bool centerHorizontally = true);

Центрирует внутренний текущий элемент по выбранным осям через ScrollBar.Value. Сначала обновите раскладку; хотя бы один флаг должен быть true. Без допустимого current ничего не делает; у краёв диапазон ограничивает центрирование.

public void Clear();

Удаляет все записи и сбрасывает выбор/внутренний текущий индекс. Не испускает ItemSelected/MultiSelected; зависимые панели обновите явно.

public void Deselect(int idx);

Снимает флаг выбранности указанной записи без сигналов выбора. В Single также сбрасывает внутренний текущий индекс, поэтому передавайте индекс действительно выбранной записи; для полного сброса используйте DeselectAll.

public void DeselectAll();

Снимает все флаги selected и сбрасывает внутренний текущий индекс без ItemSelected/MultiSelected. Полезно перед сменой режима или восстановлением выбора после перестройки.

public void EnsureCurrentIsVisible();

Запрашивает отложенный показ внутреннего текущего элемента при рисовании, не всех выбранных записей Multi/Toggle. Сам выбор не меняет. Сначала задайте размер/записи и актуальный текущий элемент одиночным Select; после структурных изменений восстановите выбор.

public void ForceUpdateListSize();

Пересчитывает геометрию списка, диапазоны прокрутки и auto-минимумы сразу, если раскладка помечена изменённой. Вызывайте после заполнения/смены размера перед GetItemRect/геометрическим поиском. Не является принудительной полной перерисовкой или сбросом всех кэшей.

public bool GetAllowReselect();

Разрешает повторное уведомление пользовательского одиночного выбора, false по умолчанию. Не заставляет прямой Select испускать ItemSelected.

public bool GetAllowRmbSelect();

Разрешает выбор правой кнопкой, false по умолчанию. Не создаёт контекстное меню и не ограничивает программный Select.

public bool GetAllowSearch();

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

public int GetFixedColumnWidth();

Заданная ширина колонки/текста в локальных пикселях, 0 по умолчанию — по содержимому. Требуется ≥ 0. Для переноса текста используйте положительную ширину вместе с IconMode.Top и MaxTextLines; межэлементные поля темы добавляются отдельно.

public Vector2I GetFixedIconSize();

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

public HScrollBar GetHScrollBar();

Общий внутренний HScrollBar. Не освобождайте/не удаляйте; горизонтальное переполнение связано с WraparoundItems = false. В RTL направление/диапазон могут отличаться от LTR.

public ItemList.IconModeEnum GetIconMode();

Основная иконка Left по умолчанию или Top. Top допускает подпись с переносом при ограниченной ширине; не меняет исходный текст или пиксели иконки.

public float GetIconScale();

Множитель размеров иконок и их места в раскладке, 1 по умолчанию. Требуется конечное число; используйте положительное значение для обычного показа. Масштабирует и FixedIconSize, не изменяя Texture2D.

public int GetItemAtPosition(Vector2 position, bool exact = false);

Ищет по локальной позиции ItemList, учитывая поля, прокрутку и RTL. exact = true требует попадания в область; false возвращает ближайшую запись и вне неё. Последняя колонка может иметь расширенную область. Disabled/nonselectable также находятся — проверяйте флаги отдельно.

public Entity.AutoTranslateModeEnum GetItemAutoTranslateMode(int idx);

Сохранённый режим перевода записи.

public int GetItemCount();

Число записей, 0 по умолчанию. Setter требует ≥ 0: новые записи пустые, selectable и не выбранные; уменьшение отбрасывает хвост без сигналов выбора. После структурной смены сбросьте/восстановите выбор явно.

public Color GetItemCustomBgColor(int idx);

Сохранённый цвет/альфа пользовательского фона.

public Color GetItemCustomFgColor(int idx);

Сохранённый цвет текста; (0, 0, 0, 1) означает использовать тему, не обязательно рисовать чёрным.

public Texture2D GetItemIcon(int idx);

Общая Texture2D иконки либо null; её исходные размеры не обязательно равны ячейке рисунка.

public Color GetItemIconModulate(int idx);

Сохранённый множитель цвета/альфы иконки.

public Rect2 GetItemIconRegion(int idx);

Сохранённый исходный Rect2, не конечная область на экране.

public string GetItemLanguage(int idx);

Сохранённый язык shaping или пустая строка для локали элемента.

public Variant GetItemMetadata(int idx);

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

public Rect2 GetItemRect(int idx, bool expand = true);

Кэшированный прямоугольник элемента в координатах содержимого с полями panel, без вычитания прокрутки и без экранного преобразования. В RTL также не считайте его готовым экранным прямоугольником. expand может расширить последнюю колонку. Перед чтением после изменений вызовите ForceUpdateListSize.

public string GetItemText(int idx);

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

public Control.TextDirection GetItemTextDirection(int idx);

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

public string GetItemTooltip(int idx);

Возвращает назначенную строку подсказки, даже когда показ выключен.

public int GetMaxColumns();

Верхняя граница числа колонок, 1 по умолчанию. 0 означает без заданного предела, а не ноль колонок. При переносе доступная ширина может уменьшить фактическое число. Требуется ≥ 0.

public int GetMaxTextLines();

Максимальное число строк подписи, 1 по умолчанию; требуется ≥ 1. Перенос применяется в IconMode.Top и требует ограниченной ширины, например FixedColumnWidth. В Left увеличение не включает многострочное размещение.

public ItemList.ScrollHintModeEnum GetScrollHintMode();

Декоративная подсказка вертикальной прокрутки: Disabled по умолчанию, Both/Top/Bottom. Использует scroll_hint темы и текущий диапазон, не включает прокрутку и не заменяет ScrollBar.

public ItemList.SelectModeEnum GetSelectMode();

Режим Single по умолчанию, Multi или Toggle. Toggle переключает выбор кликом без Ctrl. Setter сам не нормализует уже выставленные флаги выбора; для Multi/Toggle → Single сначала вызовите DeselectAll и восстановите нужную запись.

public int[] GetSelectedItems();

Новый массив выбранных индексов в порядке списка. В Single останавливается на первом флаге, даже если после смены режима остались другие. Изменение массива не меняет список.

public TextServer.OverrunBehavior GetTextOverrunBehavior();

Обрезка/многоточие текста при ограниченной ширине, TrimEllipsis по умолчанию. Само свойство не задаёт ширину и не включает перенос строк; согласуйте с FixedColumnWidth, MaxTextLines и IconMode.

public VScrollBar GetVScrollBar();

Общий внутренний VScrollBar, принадлежащий ItemList. Не освобождайте/не удаляйте. Для прокрутки используйте Value; диапазон/страница/видимость управляются раскладкой списка.

public bool HasAutoHeight();

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

public bool HasAutoWidth();

Использовать ширину содержимого как минимальную ширину Control, false по умолчанию. После пересчёта может расширить родительский контейнер и отключает обычную подгонку колонок по ширине. Для ограниченного списка оставьте false.

public bool HasWraparoundItems();

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

public bool IsAnythingSelected();

Проверяет наличие хотя бы одного selected-флага. Disabled/nonselectable у ранее выбранной записи автоматически флаг не снимают.

public bool IsItemDisabled(int idx);

Флаг disabled, не проверка выбранности.

public bool IsItemIconTransposed(int idx);

Флаг перестановки осей иконки.

public bool IsItemSelectable(int idx);

Флаг selectable, отдельный от disabled и selected.

public bool IsItemTooltipEnabled(int idx);

Флаг разрешения подсказки, не её текущая видимость.

public bool IsSameColumnWidth();

Выравнивает ширины по самому широкому элементу, false по умолчанию. Не задаёт фиксированное число колонок и не ограничивает ширину текста само по себе.

public bool IsScrollHintTiled();

Повторять текстуру scroll_hint вместо растягивания, false по умолчанию. Имеет смысл при включённом ScrollHintMode и доступном содержимом выше/ниже.

public bool IsSelected(int idx);

Возвращает selected-флаг записи. После Multi/Toggle → Single может быть true для нескольких записей до явной нормализации.

public void MoveItem(int fromIdx, int toIdx);

Переносит всю запись на конечный индекс toIdx; оба индекса 0…ItemCount-1, для конца используйте ItemCount - 1. Текст, metadata и selected перемещаются вместе. Сигналы выбора не испускаются; после перестройки явно восстановите текущий выбор по ID.

public void RemoveItem(int idx);

Удаляет запись и сдвигает последующие индексы без сигналов выбора. Сохранившиеся selected-флаги принадлежат оставшимся записям; внутренний текущий индекс не является надёжным ID. После удаления сбросьте/восстановите выбор.

public void Select(int idx, bool single = true);

Выбирает допустимую selectable и не disabled запись без ItemSelected/MultiSelected. single = true по умолчанию заменяет всё выделение; при false накопление работает в Multi или Toggle. В Single false всё равно даёт одиночный выбор.

public void SetAllowReselect(bool allow);

Разрешает повторное уведомление пользовательского одиночного выбора, false по умолчанию. Не заставляет прямой Select испускать ItemSelected.

public void SetAllowRmbSelect(bool allow);

Разрешает выбор правой кнопкой, false по умолчанию. Не создаёт контекстное меню и не ограничивает программный Select.

public void SetAllowSearch(bool allow);

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

public void SetAutoHeight(bool enable);

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

public void SetAutoWidth(bool enable);

Использовать ширину содержимого как минимальную ширину Control, false по умолчанию. После пересчёта может расширить родительский контейнер и отключает обычную подгонку колонок по ширине. Для ограниченного списка оставьте false.

public void SetFixedColumnWidth(int width);

Заданная ширина колонки/текста в локальных пикселях, 0 по умолчанию — по содержимому. Требуется ≥ 0. Для переноса текста используйте положительную ширину вместе с IconMode.Top и MaxTextLines; межэлементные поля темы добавляются отдельно.

public void SetFixedIconSize(Vector2I size);

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

public void SetIconMode(ItemList.IconModeEnum mode);

Основная иконка Left по умолчанию или Top. Top допускает подпись с переносом при ограниченной ширине; не меняет исходный текст или пиксели иконки.

public void SetIconScale(float scale);

Множитель размеров иконок и их места в раскладке, 1 по умолчанию. Требуется конечное число; используйте положительное значение для обычного показа. Масштабирует и FixedIconSize, не изменяя Texture2D.

public void SetItemAutoTranslateMode(int idx, Entity.AutoTranslateModeEnum mode);

Режим перевода записи: Inherit использует политику элемента, Always запрашивает перевод, Disabled оставляет исходный текст для показа. Не переписывает GetItemText. Поддерживает отрицательный индекс.

public void SetItemCount(int count);

Число записей, 0 по умолчанию. Setter требует ≥ 0: новые записи пустые, selectable и не выбранные; уменьшение отбрасывает хвост без сигналов выбора. После структурной смены сбросьте/восстановите выбор явно.

public void SetItemCustomBgColor(int idx, Color customBgColor);

Пользовательский фон записи, прозрачный чёрный по умолчанию. Рисуется при alpha > 0.001; это не цвет стилей selected/hovered темы. Поддерживает отрицательный индекс.

public void SetItemCustomFgColor(int idx, Color customFgColor);

Переопределяет цвет текста. Значение new Color(0, 0, 0, 1) — служебный выбор цвета темы; не путайте с new Color() в C#, у которого alpha = 0. Пользовательский цвет имеет приоритет над цветами selected/disabled темы. Поддерживает отрицательный индекс.

public void SetItemDisabled(int idx, bool disabled);

Меняет disabled-флаг: Select и пользовательский выбор отвергают такую цель. Уже выбранная запись остаётся selected. Поддерживает отрицательный индекс с конца.

public void SetItemIcon(int idx, Texture2D icon);

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

public void SetItemIconModulate(int idx, Color modulate);

Множитель цвета/альфы иконки, белый по умолчанию. Не меняет цвет текста или пиксели Texture2D. Поддерживает отрицательный индекс.

public void SetItemIconRegion(int idx, Rect2 rect);

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

public void SetItemIconTransposed(int idx, bool transposed);

Меняет местами оси иконки при рисовании и расчёте естественного размера; не редактирует текстуру. Применяется совместно с IconRegion/FixedIconSize/IconScale. Поддерживает отрицательный индекс.

public void SetItemLanguage(int idx, string language);

Язык shaping записи; пустая строка использует локаль элемента. Не переводит исходный Text. Поддерживает отрицательный индекс с конца.

public void SetItemMetadata(int idx, Variant metadata);

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

public void SetItemSelectable(int idx, bool selectable);

Разрешает/запрещает будущий выбор записи. Не снимает уже установленное выделение; вызовите Deselect отдельно, если оно должно исчезнуть. Поддерживает отрицательный индекс с конца.

public void SetItemText(int idx, string text);

Меняет исходную строку и обновляет перевод/shaping. Индекс и metadata не переписываются. Поддерживает отрицательный индекс с конца.

public void SetItemTextDirection(int idx, Control.TextDirection direction);

Направление shaping записи; Inherited берёт раскладку. Не разворачивает исходную строку. Поддерживает отрицательный индекс с конца.

public void SetItemTooltip(int idx, string tooltip);

Задаёт отдельную строку подсказки, не меняя текст записи. Поддерживает отрицательный индекс с конца. Для запрета показа используйте SetItemTooltipEnabled.

public void SetItemTooltipEnabled(int idx, bool enable);

Разрешает показ подсказки, true по умолчанию. Выключение не очищает сохранённый tooltip. Поддерживает отрицательный индекс с конца.

public void SetMaxColumns(int amount);

Верхняя граница числа колонок, 1 по умолчанию. 0 означает без заданного предела, а не ноль колонок. При переносе доступная ширина может уменьшить фактическое число. Требуется ≥ 0.

public void SetMaxTextLines(int lines);

Максимальное число строк подписи, 1 по умолчанию; требуется ≥ 1. Перенос применяется в IconMode.Top и требует ограниченной ширины, например FixedColumnWidth. В Left увеличение не включает многострочное размещение.

public void SetSameColumnWidth(bool enable);

Выравнивает ширины по самому широкому элементу, false по умолчанию. Не задаёт фиксированное число колонок и не ограничивает ширину текста само по себе.

public void SetScrollHintMode(ItemList.ScrollHintModeEnum scrollHintMode);

Декоративная подсказка вертикальной прокрутки: Disabled по умолчанию, Both/Top/Bottom. Использует scroll_hint темы и текущий диапазон, не включает прокрутку и не заменяет ScrollBar.

public void SetSelectMode(ItemList.SelectModeEnum mode);

Режим Single по умолчанию, Multi или Toggle. Toggle переключает выбор кликом без Ctrl. Setter сам не нормализует уже выставленные флаги выбора; для Multi/Toggle → Single сначала вызовите DeselectAll и восстановите нужную запись.

public void SetTextOverrunBehavior(TextServer.OverrunBehavior overrunBehavior);

Обрезка/многоточие текста при ограниченной ширине, TrimEllipsis по умолчанию. Само свойство не задаёт ширину и не включает перенос строк; согласуйте с FixedColumnWidth, MaxTextLines и IconMode.

public void SetTileScrollHint(bool tileScrollHint);

Повторять текстуру scroll_hint вместо растягивания, false по умолчанию. Имеет смысл при включённом ScrollHintMode и доступном содержимом выше/ниже.

public void SetWraparoundItems(bool enable);

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

public void SortItemsByText();

Сортирует записи сравнением исходного Text, не перевода и не locale-aware естественного порядка. Selected/metadata перемещаются вместе с записью; одинаковым строкам не приписывайте стабильный порядок. Сигналы выбора не испускаются.

public event ItemList.EmptyClickedEventHandler EmptyClicked;

Клик по пустой области. Сам по себе не обещает снятие выбора; если это нужно, вызовите DeselectAll в обработчике и обновите панель.

public event ItemList.ItemActivatedEventHandler ItemActivated;

Активация записи, обычно двойной клик или ui_accept. Не является выбором и не вызывается простым Select. Разрешение открытия/выполнения проверяйте по модели приложения.

public event ItemList.ItemClickedEventHandler ItemClicked;

Действие клика по записи; выбор мог не измениться. Передаёт индекс, локальную позицию и кнопку мыши. Для контекстного меню проверяйте кнопку отдельно от AllowRmbSelect.

public event ItemList.ItemSelectedEventHandler ItemSelected;

Уведомление пользовательского выбора в одиночном режиме. Прямой Select/Deselect/перестройка списка его не испускают. Передаёт текущий индекс, не постоянный ID.

public event ItemList.MultiSelectedEventHandler MultiSelected;

Уведомление изменения selected-флага вводом пользователя в множественном режиме. Прямой Select/Deselect его не испускают. При выборе диапазона возможны несколько событий.