Set Selection From List
TypedElementSelectionSetLibraryЧто это
Exec-функция для установки выделения набора элементов в TypedElementSelectionSet. Полностью заменяет текущий выделенный набор переданным списком элементов. Возвращает успешность операции.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (TypedElementSelectionSet) — набор выделения, в котором будет установлено новое выделение
- ElementList (Array of TypedElementHandle) — список элементов, которые станут выделенными
Выходы (данные):
- ReturnValue (bool) — true, если выделение успешно установлено; false в случае ошибки
Когда используется
Когда нужно заменить текущее выделение целиком, передав новый список элементов (например, при загрузке сохранённого состояния выделения, при программном выборе конкретного набора объектов).
Типичные проблемы
- Передача элементов из другого контекста —
TypedElementHandleдолжны быть валидны для того же мира/уровня; иначе операция завершится сfalse. - Проверка ReturnValue игнорируется — при неудачном вызове выделение остаётся прежним, но ошибка остаётся незамеченной, если не проверять возврат.
- Null Target — если
TypedElementSelectionSetне назначен, функция не выполнится корректно (вызов наnullприведёт к предупреждению или ошибке в логе).