AActor::SupportsSubRootSelection

function Engine Since 5.0

#include "GameFramework/Actor.h"

Access: public Specifiers: virtualENGINE_APIconst

Description

Returns true if this actor can be individually selected as a sub-selection within its root selection parent's group. Enables granular editing of child actors inside a group without breaking the group.

Caveats & Gotchas

• Sub-root selection is a level instance editing feature introduced to support Level Instance workflows — this function is primarily relevant when building actors intended for use as level instance content.
• The default returns false. Only return true if your actor's parent explicitly supports sub-root selection in its own selection logic, otherwise the editor may display inconsistent selection states.
• Works in conjunction with PushSelectionToProxies() — when a sub-root selection changes, that function propagates the selection state to render proxies for correct viewport highlighting.

Signature

ENGINE_API virtual bool SupportsSubRootSelection() const

Return Type

bool

Example

Allow individual selection inside a level instance group C++

bool AMyEditableChild::SupportsSubRootSelection() const
{
    // Allow this actor to be selected individually within its parent group
    return true;
}

Version History

Introduced in: 5.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?