OptionButton

public OptionButton();

Создаёт пустой выбор: Selected = -1, FitToLongestItem = true, AllowReselect = false, ToggleMode = true, ActionMode = Press. PopupMenu создаётся внутренним скрытым ребёнком.

public bool AllowReselect { get; set; }

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

public bool FitToLongestItem { get; set; }

Размер закрытой кнопки учитывает все пункты и ширину меню, true по умолчанию. Кэш обновляется отложенно; false использует текущую подпись/иконку и может менять ширину при выборе.

public int ItemCount { get; set; }

Число всех строк, включая разделители. Setter создаёт пустые строки или удаляет хвост; count должен быть неотрицательным. Первое изменение после runtime-добавления может сбросить текущий индекс: после изменения вызовите Select явно.

public bool SearchBarEnabled { get; set; }

Включает поле поиска меню, false по умолчанию. Видимость также зависит от SearchBarMinItemCount; не заменяет выбор и не меняет ID.

public bool SearchBarFuzzySearchEnabled { get; set; }

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

public int SearchBarFuzzySearchMaxMisses { get; set; }

Неотрицательное максимальное число пропусков fuzzy-поиска, 2 по умолчанию. Не означает число видимых результатов.

public int SearchBarMinItemCount { get; set; }

Неотрицательный порог показа поиска по числу строк без разделителей, 0 по умолчанию. Учитывается при включённом SearchBarEnabled.

public int Selected { get; set; }

Текущий индекс строки, -1 при отсутствии выбора. Setter/Select не испускают ItemSelected и могут выбрать отключённый пункт или разделитель. После структурных изменений явно восстановите выбор по стабильному ID.

public void AddIconItem(Texture2D texture, string label, int id = -1);

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

public void AddItem(string label, int id = -1);

Добавляет обычный пункт с подписью и ID. id = -1 использует индекс при создании. Первый доступный пункт выбирается без ItemSelected; индекс и ID не обязаны совпадать.

public void AddSeparator(string text = "");

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

public void Clear();

Удаляет все строки, очищает подпись/иконку и ставит Selected = -1. Не испускает ItemSelected.

public bool GetAllowReselect();

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

public Entity.AutoTranslateModeEnum GetItemAutoTranslateMode(int idx);

Режим перевода подписи пункта: Inherit, Always или Disabled. Изменение выбранной строки обновляет её отображение. Не переводит ID/metadata.

public int GetItemCount();

Число всех строк, включая разделители. Setter создаёт пустые строки или удаляет хвост; count должен быть неотрицательным. Первое изменение после runtime-добавления может сбросить текущий индекс: после изменения вызовите Select явно.

public Texture2D GetItemIcon(int idx);

Общая Texture2D строки либо null; setter выбранной строки обновляет иконку закрытой кнопки.

public int GetItemId(int idx);

Возвращает назначенный ID строки. Для idx = -1 возвращает -1 как отсутствие выбора, а не ID последней строки.

public int GetItemIndex(int id);

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

public Variant GetItemMetadata(int idx);

Прикладные данные Variant, независимые от подписи и ID. Изменяемые ресурсы/контейнеры могут оставаться общими.

public string GetItemText(int idx);

Исходная подпись строки; setter выбранной строки обновляет закрытую кнопку. Перевод задаётся режимом пункта.

public string GetItemTooltip(int idx);

Текст подсказки строки в меню. Не является подписью выбранной кнопки или данными выбора.

public PopupMenu GetPopup();

Возвращает общий внутренний PopupMenu. Не освобождайте и не переносите. Редактируйте строки методами OptionButton для согласованности подписи, выбора и кэша.

public int GetSearchBarFuzzySearchMaxMisses();

Неотрицательное максимальное число пропусков fuzzy-поиска, 2 по умолчанию. Не означает число видимых результатов.

public int GetSearchBarMinItemCount();

Неотрицательный порог показа поиска по числу строк без разделителей, 0 по умолчанию. Учитывается при включённом SearchBarEnabled.

public int GetSelectableItem(bool fromLast = false);

Ищет первый либо последний индекс, исключая disabled и separator. Возвращает -1 при отсутствии. Не выбирает строку и не возвращает ID.

public int GetSelected();

Текущий индекс строки, -1 при отсутствии выбора. Setter/Select не испускают ItemSelected и могут выбрать отключённый пункт или разделитель. После структурных изменений явно восстановите выбор по стабильному ID.

public int GetSelectedId();

Возвращает ID текущей строки или -1 без выбора. После удаления более ранней строки сначала восстановите валидный индекс; не используйте устаревший Selected.

public Variant GetSelectedMetadata();

Возвращает данные текущей строки либо Variant Nil без выбора. При потенциально устаревшем Selected после изменения списка сначала явно восстановите выбор.

public bool HasSelectableItems();

Есть хотя бы одна строка, которая не disabled и не separator. Это не проверка валидности текущего Selected.

public bool IsFitToLongestItem();

Размер закрытой кнопки учитывает все пункты и ширину меню, true по умолчанию. Кэш обновляется отложенно; false использует текущую подпись/иконку и может менять ширину при выборе.

public bool IsItemDisabled(int idx);

Запрет пользовательского выбора строки. Не очищает существующий выбор и не запрещает программный Select этого индекса.

public bool IsItemSeparator(int idx);

Проверяет, является ли строка разделителем. Разделители входят в ItemCount и индексы, но пропускаются GetSelectableItem.

public bool IsSearchBarEnabled();

Включает поле поиска меню, false по умолчанию. Видимость также зависит от SearchBarMinItemCount; не заменяет выбор и не меняет ID.

public bool IsSearchBarFuzzySearchEnabled();

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

public void RemoveItem(int idx);

Удаляет строку по индексу. Удаление выбранной очищает выбор. Удаление перед выбранной в текущей реализации не уменьшает сохранённый индекс; сохраните ID заранее и восстановите Select(GetItemIndex(id)) после проверки результата.

public void Select(int idx);

Выбирает существующий индекс строки без ItemSelected; -1 очищает выбор. Не передавайте сюда ID. Метод не исключает disabled/separator и не исправляет модель приложения автоматически.

public void SetAllowReselect(bool allow);

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

public void SetDisableShortcuts(bool disabled);

Отключает локальную обработку сочетаний списка и унаследованной кнопки. Не меняет InputMap приложения и не отключает обычные Select/методы списка.

public void SetFitToLongestItem(bool fit);

Размер закрытой кнопки учитывает все пункты и ширину меню, true по умолчанию. Кэш обновляется отложенно; false использует текущую подпись/иконку и может менять ширину при выборе.

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

Режим перевода подписи пункта: Inherit, Always или Disabled. Изменение выбранной строки обновляет её отображение. Не переводит ID/metadata.

public void SetItemCount(int count);

Число всех строк, включая разделители. Setter создаёт пустые строки или удаляет хвост; count должен быть неотрицательным. Первое изменение после runtime-добавления может сбросить текущий индекс: после изменения вызовите Select явно.

public void SetItemDisabled(int idx, bool disabled);

Запрет пользовательского выбора строки. Не очищает существующий выбор и не запрещает программный Select этого индекса.

public void SetItemIcon(int idx, Texture2D texture);

Общая Texture2D строки либо null; setter выбранной строки обновляет иконку закрытой кнопки.

public void SetItemId(int idx, int id);

Задаёт ID существующей строки без изменения индекса. Уникальность не проверяется; избегайте одинаковых ID.

public void SetItemMetadata(int idx, Variant metadata);

Прикладные данные Variant, независимые от подписи и ID. Изменяемые ресурсы/контейнеры могут оставаться общими.

public void SetItemText(int idx, string text);

Исходная подпись строки; setter выбранной строки обновляет закрытую кнопку. Перевод задаётся режимом пункта.

public void SetItemTooltip(int idx, string tooltip);

Текст подсказки строки в меню. Не является подписью выбранной кнопки или данными выбора.

public void SetSearchBarEnabled(bool enabled);

Включает поле поиска меню, false по умолчанию. Видимость также зависит от SearchBarMinItemCount; не заменяет выбор и не меняет ID.

public void SetSearchBarFuzzySearchEnabled(bool enabled);

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

public void SetSearchBarFuzzySearchMaxMisses(int maxMisses);

Неотрицательное максимальное число пропусков fuzzy-поиска, 2 по умолчанию. Не означает число видимых результатов.

public void SetSearchBarMinItemCount(int count);

Неотрицательный порог показа поиска по числу строк без разделителей, 0 по умолчанию. Учитывается при включённом SearchBarEnabled.

public void ShowPopup();

Открывает список при наличии Viewport. Не равно Select и не подтверждает пункт. Прямой вызов не использует проверку Disabled из Press; вызывайте для активной кнопки в дереве.

public event OptionButton.ItemFocusedEventHandler ItemFocused;

Индекс подсвеченной строки, long в C#. Не подтверждает выбор и не обязан совпадать с Selected.

public event OptionButton.ItemSelectedEventHandler ItemSelected;

Индекс выбранной через меню строки, long в C#. Это не ID. Select и автоматический выбор при добавлении сигнал не испускают; AllowReselect управляет повторным выбором того же пункта.