Get Element Handle At
TypedElementListLibraryЧто это
Pure-функция библиотеки TypedElementListLibrary. Возвращает хендл (дескриптор) элемента из списка Typed Element List по указанному индексу. Не требует выполнения (pure), не изменяет состояние.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Typed Element List) — список элементов
- Index (Integer) — позиция элемента в списке (отсчёт от 0)
Выходы (данные):
- ReturnValue (Script Typed Element Handle) — хендл (дескриптор) элемента по индексу
Когда используется
При работе с Typed Elements, когда нужно получить доступ к конкретному элементу по его порядковому номеру в списке. Часто применяется внутри циклов по списку (например, после GetNumElements).
Типичные проблемы
- Выход индекса за границы списка (меньше 0 или больше LastIndex) — функция вернёт недействительный хендл. Перед вызовом обязательно проверять количество элементов.
- Хендл может стать недействительным, если элемент был удалён из мира после того, как список сформирован. Повторное использование такого хендла может привести к ошибкам.