Delete Normalized Elements
TypedElementCommonActionsЧто это
Exec-функция класса TypedElementCommonActions. Удаляет переданный массив элементов через Typed Elements Framework. Возвращает true, если все элементы успешно удалены, иначе false. Используется для массового удаления объектов (актёров, компонентов и т.д.), представленных в виде FTypedElementHandle.
Пины
Exec-входы:
- execute (exec) — запуск удаления.
Exec-выходы:
- then (exec) — продолжение выполнения после завершения операции.
Входы (данные):
- Target (TypedElementCommonActions) — self, ссылка на объект, предоставляющий общие действия с элементами.
- Elements (Array of Typed Element Handle) — массив дескрипторов элементов, которые нужно удалить.
Выходы (данные):
- ReturnValue (bool) —
true, если все элементы удалены успешно;false, если хотя бы один элемент не удалось удалить (например, элемент уже удалён или невалиден).
Когда используется
- Очистка сцены от группы объектов (например, удаление всех временных спавнов).
- Массовое удаление элементов после завершения операции (например, после парсинга данных).
- В сочетании с
GetSelectedElementsилиGetNormalizedElementsдля удаления выделенных объектов.
Типичные проблемы
- Игнорирование возвращаемого значения — если не проверить
ReturnValue, можно не заметить, что часть элементов не удалилась (например, из-за невалидных хендлов). - Передача массива с дубликатами — функция ожидает нормализованный массив (без повторений). Если передать дубликаты, поведение не определено (может привести к лишним вызовам удаления или ошибкам).
- Удаление уже удалённых элементов — повторный вызов с теми же хендлами приведёт к
false, так как элементы уже не существуют. Рекомендуется очищать массив после успешного удаления.