Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > Engine > GameFramework > AActor > AActor::AddComponentByClass

Light Theme

Dark Theme

AActor::AddComponentByClass

Creates a new component and assigns ownership to the Actor this is called for.

Windows

MacOS

Linux

References

Module	Engine
Header	/Engine/Source/Runtime/Engine/Classes/GameFramework/Actor.h
Include	#include "GameFramework/Actor.h"
Source	/Engine/Source/Runtime/Engine/Private/ActorConstruction.cpp

Syntax

UActorComponent * AddComponentByClass
(
    TSubclassOf< UActorComponent > Class,
    bool bManualAttachment,
    const FTransform & RelativeTransform,
    bool bDeferredFinish
)

Remarks

Creates a new component and assigns ownership to the Actor this is called for. Automatic attachment causes the first component created to become the root, and all subsequent components to be attached under that root. When bManualAttachment is set, automatic attachment is skipped and it is up to the user to attach the resulting component (or set it up as the root) themselves.

Parameters

Parameter	Description
Class	The class of component to create
bManualAttachment	Whether manual or automatic attachment is to be used
RelativeTransform	The relative transform between the new component and its attach parent (automatic only)
bDeferredFinish	Whether or not to immediately complete the creation and registration process for this component. Will be false if there are expose on spawn properties being set