UPopupWidgetBase 클래스 참조

#include <PopupWidgetBase.h>

UPopupWidgetBase에 대한 상속 다이어그램 :

UPopupWidgetBase에 대한 협력 다이어그램:

Public 멤버 함수
virtual void	OnPoppedFromLayer () override
virtual void	BeginDestroy () override
void	Close (EPopupResult Result)
void	FinishClose ()
FORCEINLINE EPopupResult	GetResult () const
FORCEINLINE bool	IsClosing () const
UUserWidgetBase(으)로부터 상속된 Public 멤버 함수
virtual void	SetAbilitySystemComponent (AActor *InOwner)
virtual UAbilitySystemComponent *	GetAbilitySystemComponent () const override
virtual void	OnPushedToLayer ()
virtual void	OnActivated ()
virtual void	OnDeactivated ()
void	Activate ()
void	Deactivate ()
FORCEINLINE FGameplayTag	GetLayerTag () const
FORCEINLINE void	SetLayerTag (const FGameplayTag InTag)
FORCEINLINE bool	IsPrimary () const
FORCEINLINE void	SetPrimary (const bool InPrimary)
FORCEINLINE EWidgetState	GetWidgetState () const
FORCEINLINE void	SetWidgetState (const EWidgetState InState)
FORCEINLINE UWaitForWidgetActivation *	GetActivationHandle ()
FORCEINLINE bool	HasAppearanceAnim () const
FORCEINLINE bool	HasDisappearanceAnim () const

Public 속성
FOnPopupClosed	OnPopupClosed

Protected 멤버 함수
void	OnCloseRequested (EPopupResult Result)
virtual void	OnCloseRequested_Implementation (EPopupResult Result)
UUserWidgetBase(으)로부터 상속된 Protected 멤버 함수
virtual void	OnWidgetActivated ()
virtual void	OnWidgetDeactivated ()
void	OnPushedToLayer_Internal ()
void	OnPoppedFromLayer_Internal ()
void	OnActivated_Internal ()
void	OnDeactivated_Internal ()

Private 멤버 함수
void	BroadcastResultIfNeeded (EPopupResult Result)

Private 속성
EPopupResult	CachedResult = EPopupResult::Dismissed
bool	bClosing = false
bool	bClosed = false
bool	bResultBroadcasted = false

추가로 상속된 멤버들
UUserWidgetBase(으)로부터 상속된 Protected 속성
EWidgetState	WidgetState
TObjectPtr< UAbilitySystemComponent >	ASC
FGameplayTag	LayerTag
bool	bPrimary = false
TObjectPtr< UWidgetAnimation >	AppearanceAnim
TObjectPtr< UWidgetAnimation >	DisappearanceAnim

상세한 설명

결과(EPopupResult)를 반환하고 스스로 닫히는 위젯의 베이스. 푸시/레이어/입력은 UIManagementSubsystem이 담당하고, 이 클래스는 결과 계약과 2단계 닫기만 책임진다. 내용/연출/레이아웃은 BP 파생 위젯에서 구현한다.

멤버 함수 문서화

BeginDestroy()

void UPopupWidgetBase::BeginDestroy ( )

overridevirtual

{
    // 최종 안전망: ClearWidget/PopAllLayer/레벨 언로드 등 OnPoppedFromLayer를 거치지 않는 정리 경로 대비.
    BroadcastResultIfNeeded(CachedResult);
    Super::BeginDestroy();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

BroadcastResultIfNeeded()

void UPopupWidgetBase::BroadcastResultIfNeeded ( EPopupResult  Result )

private

{
    if (bResultBroadcasted)
    {
        return;
    }
 
    bResultBroadcasted = true;
    OnPopupClosed.Broadcast(this, Result);
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

Close()

void UPopupWidgetBase::Close

(

EPopupResult

Result

)

{
    if (bClosing)
    {
        return;
    }
 
    bClosing = true;
    CachedResult = Result;
 
    // 여기서 Disappearing 으로 바꾸면 PopWidget 이 "이미 퇴장 중"으로 보고 그냥 반환한다.
    // 그러면 Deactivate/PopWidgetFromLayer 가 돌지 않아 위젯이 레이어에 남고,
    // 레이어 설정(입력 모드/TimeScale)이 계속 적용된 채 풀리지 않는다.
    // 상태 전환은 Deactivate 가 맡는다. 재진입은 bClosing 으로 이미 막고 있다.
    OnCloseRequested(Result);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

FinishClose()

void UPopupWidgetBase::FinishClose

(

)

{
    if (bClosed)
    {
        return;
    }
 
    bClosed = true;
    BroadcastResultIfNeeded(CachedResult);
 
    const UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        LOG_ERROR(LogCK, "%s를 가져올 수 없음. ", NAMEOF(UWorld));
        return;
    }
 
    if (UUIManagementSubsystem* UISubsystem = UCK_BPFunctionLibrary::GetUIManagementSubsystem(World))
    {
        // PopWidget 내부에서 Deactivate → RemoveFromParent → OnPoppedFromLayer 처리.
        UISubsystem->PopWidget(this);
    }
    else
    {
        LOG_WARNING(LogCK, "%s: %s을 찾지 못해 직접 RemoveFromParent. ", *GetName(), NAMEOF(UUIManagementSubsystem));
        RemoveFromParent();
    }
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetResult()

FORCEINLINE EPopupResult UPopupWidgetBase::GetResult ( ) const

inline

    {
        return CachedResult;
    }

IsClosing()

FORCEINLINE bool UPopupWidgetBase::IsClosing ( ) const

inline

    {
        return bClosing;
    }

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnCloseRequested()

void UPopupWidgetBase::OnCloseRequested ( EPopupResult  Result )

protected

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnCloseRequested_Implementation()

void UPopupWidgetBase::OnCloseRequested_Implementation ( EPopupResult  Result )

protectedvirtual

{
    // 기본 동작: 연출 없이 즉시 닫는다.
    FinishClose();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

OnPoppedFromLayer()

void UPopupWidgetBase::OnPoppedFromLayer ( )

overridevirtual

UUserWidgetBase(으)로부터 재구현되었습니다.

{
    Super::OnPoppedFromLayer();
 
    // 외부에서 Subsystem::PopWidget으로 직접 닫힌 경우(Close를 거치지 않음) 결과 누락 방지.
    BroadcastResultIfNeeded(CachedResult);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

bClosed

bool UPopupWidgetBase::bClosed = false

private

bClosing

bool UPopupWidgetBase::bClosing = false

private

bResultBroadcasted

bool UPopupWidgetBase::bResultBroadcasted = false

private

CachedResult

EPopupResult UPopupWidgetBase::CachedResult = EPopupResult::Dismissed

private

OnPopupClosed

FOnPopupClosed UPopupWidgetBase::OnPopupClosed

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/CK_UE/UI/Popup/PopupWidgetBase.h
• Source/CK_UE/UI/Popup/PopupWidgetBase.cpp