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 > CoreUObject > UObject > UObject > CreateOptionalDefaultSubobject > UObject::CreateOptionalDefaultSubobject

Light Theme

Dark Theme

UObject::CreateOptionalDefaultSubobject

Create an optional component or subobject.

Windows

MacOS

Linux

References

Module	CoreUObject
Header	/Engine/Source/Runtime/CoreUObject/Public/UObject/Object.h
Include	#include "UObject/Object.h"

Syntax

template<class TReturnType, class TClassToConstructByDefault>
TReturnType * CreateOptionalDefaultSubobject
(
FName SubobjectName,
bool bTransient
)

Remarks

Create an optional component or subobject. Optional subobjects will not get created if a derived class specified DoNotCreateDefaultSubobject with the subobject's name.

Parameters

Parameter	Description
TReturnType	Class of return type, all overrides must be of this type
TClassToConstructByDefault	Class of object to actually construct, must be a subclass of TReturnType
SubobjectName	Name of the new component
bTransient	True if the component is being assigned to a transient property. This does not make the component itself transient, but does stop it from inheriting parent defaults

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.

Take our survey

Dismiss