RealDocs

AActor::GetAllChildActors

function Engine Blueprint Since 4.14
#include "GameFramework/Actor.h"
Access: public Specifiers: UFUNCTIONBlueprintCallableENGINE_API

Description

Fills an array with all actors spawned by `UChildActorComponent` instances on this actor. Optionally recurses into nested child actors.

Caveats & Gotchas

  • • This function populates the output array with actors spawned by `UChildActorComponent` specifically — it does **not** return actors from the `Children` array (actors that were attached via `AttachToActor`). These are two different concepts.
  • • With `bIncludeDescendants = true`, the recursion can be expensive for deep hierarchies. If you only need to iterate once per frame, cache the result rather than calling this in Tick.

Signature

ENGINE_API void GetAllChildActors(TArray<AActor*>& ChildActors, bool bIncludeDescendants = true) const;

Parameters

Name Type Description Default
ChildActors TArray<AActor*>& Output array filled with all child actor instances. —
bIncludeDescendants bool If true, recursively include children of children. If false, only direct children are returned. true

Return Type

void

Example

Notify all child actors of an event C++
void AMyParentActor::AlertChildren()
{
	TArray<AActor*> Children;
	GetAllChildActors(Children, /*bIncludeDescendants=*/true);
	for (AActor* Child : Children)
	{
		if (IAlertable* Alertable = Cast<IAlertable>(Child))
		{
			Alertable->OnAlert();
		}
	}
}

Version History

Introduced in: 4.14

Version Status Notes
5.6 stable —

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.