#include <UPopup_History.h>

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

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

Public 멤버 함수
void	InitPopup ()
	팝업 초기화

virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override

void	OpenAnimation ()
	팝업 오픈 애니메이션을 재생합니다

Public 속성
bool	bAllowPlayerControl = false
	이 팝업이 활성화되어 있을 때 플레이어 조작을 허용할지 여부

Protected 멤버 함수
virtual void	NativeConstruct () override

void	UpdateAnimation (float InDeltaTime)
	스크립트 오픈 애니메이션 업데이트

Protected 속성
bool	bIsOpenAnim = false
	애니메이션 재생 중 여부

UWidgetAnimation *	BlueprintOpenAnimation
	블루프린트에서 정의한 오픈 애니메이션

TObjectPtr< class UBorder >	Border_NoData
	데이터가 없을 때 표시할 텍스트

TObjectPtr< class UTextureButton >	Btn_Close
	닫기 버튼

TSubclassOf< class UHistoryItem >	HistoryItemClass
	히스토리 항목 위젯 클래스

float	ItemSpacing = 15.0f
	히스토리 항목 간 간격 (Spacer Height)

EGameSoundType	OpenAnimSound = EGameSoundType::UI_PopupOpen
	팝업 오픈 시 재생될 사운드 타입

float	OpenDuration = 0.2f
	애니메이션 지속 시간

EEaseType	OpenEaseType = EEaseType::EaseOutBack
	Easing 타입

float	OpenElapsedTime = 0.0f
	경과 시간

FVector2D	OpenPivot = FVector2D(0.5f, 0.5f)
	애니메이션 중심점 (0~1 범위)

float	OpenStartScale = 0.8f
	시작 스케일

float	OpenTargetScale = 1.0f
	목표 스케일

EPopupType	PopupType

TObjectPtr< class UScrollBox >	ScrollBox
	스크롤 가능한 히스토리 패널

TObjectPtr< class UTextBlock >	Txt_Title
	팝업 타이틀

TObjectPtr< class UVerticalBox >	VerticalBox
	히스토리 항목들이 추가될 VerticalBox

Private 멤버 함수
void	OnClickClose ()

void	RefreshHistoryList ()
	히스토리 아이템을 생성하여 VerticalBox에 추가합니다.

상세한 설명

Chat History 팝업

ScrollBox + VerticalBox 구조로 히스토리 아이템을 표시합니다.

UPopup_History.h 파일의 15 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ InitPopup()

void UPopup_History::InitPopup ( )

팝업 초기화

UPopup_History.cpp 파일의 29 번째 라인에서 정의되었습니다.

{
    RefreshHistoryList();
}

다음을 참조함 : RefreshHistoryList().

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

◆ NativeConstruct()

void UPopup_History::NativeConstruct ( )

overrideprotectedvirtual

UPopup_History.cpp 파일의 17 번째 라인에서 정의되었습니다.

{
    Super::NativeConstruct();
 
    // 버튼 바인딩
    if (Btn_Close)
    {
        Btn_Close->OnButtonClickedEvent.RemoveDynamic(this, &UPopup_History::OnClickClose);
        Btn_Close->OnButtonClickedEvent.AddDynamic(this, &UPopup_History::OnClickClose);
    }
}

다음을 참조함 : Btn_Close, OnClickClose().

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

◆ NativeTick()

void UBasePopup::NativeTick	(	const FGeometry &	MyGeometry,
		float	InDeltaTime
	)

overridevirtualinherited

UBasePopup.cpp 파일의 7 번째 라인에서 정의되었습니다.

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    if (bIsOpenAnim)
    {
        UpdateAnimation(InDeltaTime);
    }
}

다음을 참조함 : UBasePopup::bIsOpenAnim, UBasePopup::UpdateAnimation().

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

◆ OnClickClose()

void UPopup_History::OnClickClose ( )

private

UPopup_History.cpp 파일의 97 번째 라인에서 정의되었습니다.

{
    if (UPopupManager* PopupManager = UPopupManager::Get(GetWorld()))
    {
        PopupManager->HideCurrentPopup();
    }
}

다음에 의해서 참조됨 : NativeConstruct().

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

◆ OpenAnimation()

void UBasePopup::OpenAnimation ( )

inherited

팝업 오픈 애니메이션을 재생합니다

UBasePopup.cpp 파일의 17 번째 라인에서 정의되었습니다.

{
    if (!IsInViewport())
    {
        AddToViewport();
    }
 
    // 팝업 오픈 사운드 재생 (None이 아닐 때만)
    if (OpenAnimSound != EGameSoundType::None)
    {
        if (UGameSoundManager* SoundManager = UGameSoundManager::Get(this))
        {
            SoundManager->PlaySound2D(OpenAnimSound);
        }
    }
 
    // 블루프린트에서 정의한 애니메이션이 있으면 해당 애니메이션 재생
    if (BlueprintOpenAnimation)
    {
        PlayAnimation(BlueprintOpenAnimation);
        return;
    }
 
    // 블루프린트 애니메이션이 없으면 기본 스크립트 애니메이션 사용
    SetRenderTransformPivot(OpenPivot);
    SetRenderScale(FVector2D(OpenStartScale, OpenStartScale));
 
    bIsOpenAnim = OpenDuration > KINDA_SMALL_NUMBER;
    OpenElapsedTime = 0.0f;
 
    if (!bIsOpenAnim)
    {
        SetRenderScale(FVector2D(OpenTargetScale, OpenTargetScale));
    }
}

다음을 참조함 : UBasePopup::bIsOpenAnim, UBasePopup::BlueprintOpenAnimation, None, UBasePopup::OpenAnimSound, UBasePopup::OpenDuration, UBasePopup::OpenElapsedTime, UBasePopup::OpenPivot, UBasePopup::OpenStartScale, UBasePopup::OpenTargetScale.

◆ RefreshHistoryList()

void UPopup_History::RefreshHistoryList ( )

private

히스토리 아이템을 생성하여 VerticalBox에 추가합니다.

UPopup_History.cpp 파일의 34 번째 라인에서 정의되었습니다.

{
    // 기존 항목 제거
    VerticalBox->ClearChildren();
 
    // ChatHistorySystem에서 히스토리 로드
    APlayerControl* PC = ULingoGameHelper::GetPlayerControl(GetWorld());
    if (!PC || !PC->GetChatHistorySystem())
    {
        Border_NoData->SetVisibility(ESlateVisibility::Visible);
        if (ScrollBox)
        {
            ScrollBox->SetVisibility(ESlateVisibility::Hidden);
        }
        return;
    }
 
    TArray<FChatHistoryItem> HistoryList;
    const int32 Count = PC->GetChatHistorySystem()->LoadAllChatHistory(HistoryList);
 
    if (Count == 0)
    {
        Border_NoData->SetVisibility(ESlateVisibility::Visible);
        if (ScrollBox)
        {
            ScrollBox->SetVisibility(ESlateVisibility::Hidden);
        }
        return;
    }
 
    // 히스토리 아이템 생성 (Index 순서대로 = 상단이 구 데이터, 하단이 신 데이터)
    Border_NoData->SetVisibility(ESlateVisibility::Hidden);
    if (ScrollBox)
        ScrollBox->SetVisibility(ESlateVisibility::Visible);
 
    for (int32 i = 0; i < HistoryList.Num(); ++i)
    {
        if (!HistoryItemClass)
        {
            continue;
        }
 
        UHistoryItem* ItemWidget = CreateWidget<UHistoryItem>(this, HistoryItemClass);
        if (!ItemWidget)
        {
            continue;
        }
 
        ItemWidget->InitItem(HistoryList[i]);
        VerticalBox->AddChildToVerticalBox(ItemWidget);
 
        // Spacer 추가 (마지막 항목 제외)
        // if (i < HistoryList.Num() - 1)
        {
            USpacer* Spacer = NewObject<USpacer>(VerticalBox);
            Spacer->SetSize(FVector2D(1.0f, ItemSpacing));
            VerticalBox->AddChildToVerticalBox(Spacer);
        }
    }
 
    PRINTLOG(TEXT("[Popup_History] Refreshed %d items"), Count);
}

다음을 참조함 : Border_NoData, APlayerControl::GetChatHistorySystem(), ULingoGameHelper::GetPlayerControl(), HistoryItemClass, UHistoryItem::InitItem(), ItemSpacing, PRINTLOG, ScrollBox, VerticalBox.

다음에 의해서 참조됨 : InitPopup().

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

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

◆ UpdateAnimation()

void UBasePopup::UpdateAnimation ( float InDeltaTime )

protectedinherited

스크립트 오픈 애니메이션 업데이트

UBasePopup.cpp 파일의 53 번째 라인에서 정의되었습니다.

{
    if (!bIsOpenAnim)
    {
        return;
    }
 
    OpenElapsedTime += InDeltaTime;
 
    const float Alpha = FMath::Clamp(OpenElapsedTime / OpenDuration, 0.0f, 1.0f);
    const float EasedAlpha = FEaseHelper::Ease(Alpha, OpenEaseType);
    const float NewScale = FMath::Lerp(OpenStartScale, OpenTargetScale, EasedAlpha);
 
    SetRenderScale(FVector2D(NewScale, NewScale));
 
    if (Alpha >= 1.0f)
    {
        bIsOpenAnim = false;
    }
}

다음을 참조함 : UBasePopup::bIsOpenAnim, FEaseHelper::Ease(), UBasePopup::OpenDuration, UBasePopup::OpenEaseType, UBasePopup::OpenElapsedTime, UBasePopup::OpenStartScale, UBasePopup::OpenTargetScale.

다음에 의해서 참조됨 : UBasePopup::NativeTick().

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

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

멤버 데이터 문서화

◆ bAllowPlayerControl

bool UBasePopup::bAllowPlayerControl = false

inherited

이 팝업이 활성화되어 있을 때 플레이어 조작을 허용할지 여부

true면 이 팝업이 열려있어도 플레이어가 캐릭터를 조작할 수 있습니다. 기본값은 false (대부분의 팝업은 플레이어 조작을 차단)

UBasePopup.h 파일의 105 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UPopup_DailyStudy::NativeConstruct(), UPopup_SpeakQuestJudes::NativeConstruct().

◆ bIsOpenAnim

bool UBasePopup::bIsOpenAnim = false

protectedinherited

애니메이션 재생 중 여부

UBasePopup.h 파일의 57 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::NativeTick(), UBasePopup::OpenAnimation(), UBasePopup::UpdateAnimation().

◆ BlueprintOpenAnimation

UWidgetAnimation* UBasePopup::BlueprintOpenAnimation

protectedinherited

블루프린트에서 정의한 오픈 애니메이션

설정된 경우 스크립트 애니메이션 대신 이 애니메이션을 재생합니다.

UBasePopup.h 파일의 45 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation().

◆ Border_NoData

TObjectPtr<class UBorder> UPopup_History::Border_NoData

protected

데이터가 없을 때 표시할 텍스트

UPopup_History.h 파일의 55 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RefreshHistoryList().

◆ Btn_Close

TObjectPtr<class UTextureButton> UPopup_History::Btn_Close

protected

닫기 버튼

UPopup_History.h 파일의 43 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : NativeConstruct().

◆ HistoryItemClass

TSubclassOf<class UHistoryItem> UPopup_History::HistoryItemClass

protected

히스토리 항목 위젯 클래스

UPopup_History.h 파일의 61 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RefreshHistoryList().

◆ ItemSpacing

float UPopup_History::ItemSpacing = 15.0f

protected

히스토리 항목 간 간격 (Spacer Height)

UPopup_History.h 파일의 67 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RefreshHistoryList().

◆ OpenAnimSound

EGameSoundType UBasePopup::OpenAnimSound = EGameSoundType::UI_PopupOpen

protectedinherited

팝업 오픈 시 재생될 사운드 타입

블루프린트에서 팝업별로 다른 사운드를 설정할 수 있습니다. None으로 설정하면 사운드를 재생하지 않습니다. 기본값은 UI_PopupOpen입니다.

UBasePopup.h 파일의 96 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation().

◆ OpenDuration

float UBasePopup::OpenDuration = 0.2f

protectedinherited

애니메이션 지속 시간

UBasePopup.h 파일의 64 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation(), UBasePopup::UpdateAnimation().

◆ OpenEaseType

EEaseType UBasePopup::OpenEaseType = EEaseType::EaseOutBack

protectedinherited

Easing 타입

애니메이션의 보간 곡선을 선택합니다. 기본값은 EaseOutBack (탄성 효과)

UBasePopup.h 파일의 83 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::UpdateAnimation().

◆ OpenElapsedTime

float UBasePopup::OpenElapsedTime = 0.0f

protectedinherited

경과 시간

UBasePopup.h 파일의 60 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation(), UBasePopup::UpdateAnimation().

◆ OpenPivot

FVector2D UBasePopup::OpenPivot = FVector2D(0.5f, 0.5f)

protectedinherited

애니메이션 중심점 (0~1 범위)

UBasePopup.h 파일의 76 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation().

◆ OpenStartScale

float UBasePopup::OpenStartScale = 0.8f

protectedinherited

시작 스케일

UBasePopup.h 파일의 68 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation(), UBasePopup::UpdateAnimation().

◆ OpenTargetScale

float UBasePopup::OpenTargetScale = 1.0f

protectedinherited

목표 스케일

UBasePopup.h 파일의 72 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UBasePopup::OpenAnimation(), UBasePopup::UpdateAnimation().

◆ PopupType

EPopupType UBasePopup::PopupType

protectedinherited

UBasePopup.h 파일의 34 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : UPopup_InputMsg::InitPopup(), UPopup_InputMsg::OnClickOk().

◆ ScrollBox

TObjectPtr<class UScrollBox> UPopup_History::ScrollBox

protected

스크롤 가능한 히스토리 패널

UPopup_History.h 파일의 47 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RefreshHistoryList().

◆ Txt_Title

TObjectPtr<class UTextBlock> UPopup_History::Txt_Title

protected

팝업 타이틀

UPopup_History.h 파일의 39 번째 라인에서 정의되었습니다.

◆ VerticalBox

TObjectPtr<class UVerticalBox> UPopup_History::VerticalBox

protected

히스토리 항목들이 추가될 VerticalBox

UPopup_History.h 파일의 51 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RefreshHistoryList().

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

Source/Onepiece/MessageBox/Public/UPopup_History.h
Source/Onepiece/MessageBox/Private/UPopup_History.cpp

Public 멤버 함수

Public 속성

Protected 멤버 함수

Protected 속성

Private 멤버 함수

상세한 설명

멤버 함수 문서화

◆ InitPopup()

◆ NativeConstruct()

◆ NativeTick()

◆ OnClickClose()

◆ OpenAnimation()

◆ RefreshHistoryList()

◆ UpdateAnimation()

멤버 데이터 문서화

◆ bAllowPlayerControl

◆ bIsOpenAnim

◆ BlueprintOpenAnimation

◆ Border_NoData

◆ Btn_Close

◆ HistoryItemClass

◆ ItemSpacing

◆ OpenAnimSound

◆ OpenDuration

◆ OpenEaseType

◆ OpenElapsedTime

◆ OpenPivot

◆ OpenStartScale

◆ OpenTargetScale

◆ PopupType

◆ ScrollBox

◆ Txt_Title

◆ VerticalBox