PopupWidgetBase.h

이 파일의 문서화 페이지로 가기

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "EPopupResult.h"
#include "UI/UserWidgetBase.h"
#include "PopupWidgetBase.generated.h"
 
 
class UPopupWidgetBase;
 
 
// 결과 통지 델리게이트. 외부는 여기에 바인딩만 한다(느슨한 결합).
DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnPopupClosed, UPopupWidgetBase*, Popup, EPopupResult, Result);
 
 
UCLASS()
class CK_UE_API UPopupWidgetBase : public UUserWidgetBase
{
    GENERATED_BODY()
 
public:
    virtual void OnPoppedFromLayer() override;
    virtual void BeginDestroy() override;
 
public:
    // 닫기 진입점(2단계 닫기 1단계). 결과를 확정하고 닫기 연출을 시작한다.
    // 결과를 가진 모든 닫기는 이 함수를 통한다.
    UFUNCTION(BlueprintCallable, Category = "UI|Popup")
    void Close(EPopupResult Result);
 
    // 2단계 닫기 마지막 단계. 닫기 연출이 끝난 뒤 호출해 실제 Pop을 수행한다.
    // OnCloseRequested 기본 구현이 자동 호출하므로, 연출을 넣은 BP만 직접 호출하면 된다.
    UFUNCTION(BlueprintCallable, Category = "UI|Popup")
    void FinishClose();
 
public:
    FORCEINLINE EPopupResult GetResult() const
    {
        return CachedResult;
    }
 
    FORCEINLINE bool IsClosing() const
    {
        return bClosing;
    }
 
protected:
    // 닫기 연출 훅. 기본 구현은 즉시 FinishClose()를 호출한다.
    // BP에서 오버라이드해 fade-out 등을 재생한 뒤 직접 FinishClose()를 호출하면 연출이 적용된다.
    UFUNCTION(BlueprintNativeEvent, Category = "UI|Popup")
    void OnCloseRequested(EPopupResult Result);
    
    virtual void OnCloseRequested_Implementation(EPopupResult Result);
 
private:
    void BroadcastResultIfNeeded(EPopupResult Result);
 
public:
    UPROPERTY(BlueprintAssignable, Category = "UI|Popup")
    FOnPopupClosed OnPopupClosed;
 
private:
    UPROPERTY(Transient, BlueprintReadOnly, Category = "UI|Popup", meta = (AllowPrivateAccess = "true"))
    EPopupResult CachedResult = EPopupResult::Dismissed;
 
private:
    bool bClosing = false;
    bool bClosed = false;
    bool bResultBroadcasted = false;
};