Count Selected Objects
TypedElementSelectionSetЧто это
Pure-функция, возвращающая количество объектов, содержащихся в наборе выбранных элементов (TypedElementSelectionSet). Не изменяет состояние набора, не имеет exec-пинов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (TypedElementSelectionSet) — набор выбранных элементов, для которого подсчитывается количество объектов.
Выходы (данные):
- Return Value (int) — количество объектов в наборе.
Когда используется
Для проверки количества выделенных объектов перед выполнением массовых операций, для условной логики (например, «если выбрано больше одного объекта — показать контекстное меню»), для отображения счётчика в интерфейсе.
Типичные проблемы
- Вызов на неинициализированном (null) наборе приводит к ошибке выполнения — перед вызовом следует убедиться, что ссылка на набор существует.
- Функция возвращает 0, если набор пуст; это штатное поведение, но разработчик может ошибочно ожидать другого значения (например, -1) или не учесть пустой набор в условиях.
- Если требуется проверить только наличие хотя бы одного выделенного объекта, эффективнее использовать специализированную функцию (например, «Has Selected Objects»), чтобы избежать лишнего подсчёта.