Get Element Interface
TypedElementListLibraryЧто это
Pure-функция, возвращающая интерфейс, реализованный элементом коллекции Typed Elements. Позволяет получить доступ к методам конкретного интерфейса для заданного элемента, если он этот интерфейс поддерживает. Тип: pure (не имеет exec-пинов).
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (Typed Element List Library) — ссылка на коллекцию элементов
- Element Handle (Script Typed Element Handle) — дескриптор элемента, для которого запрашивается интерфейс
- Interface Type (Object Type Reference) — класс интерфейса, который нужно получить
Выходы (данные):
- Return Value (Object Reference) — объект, реализующий запрошенный интерфейс, или None, если элемент не поддерживает интерфейс
Когда используется
Для вызова методов интерфейса у элемента коллекции Typed Elements, когда заранее неизвестно, поддерживает ли элемент этот интерфейс. Позволяет безопасно проверить поддержку интерфейса и получить ссылку на его реализацию.
Типичные проблемы
- Передача некорректного дескриптора элемента (Element Handle), полученного из другой коллекции или устаревшего.
- Указание неправильного типа интерфейса (Interface Type), который элемент не поддерживает — функция вернёт None, что может привести к ошибкам при дальнейшем использовании без проверки.