#include <UToastWidget.h>

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

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

Public 멤버 함수
void	AddItemToBoxItem (const FResultStatData &InData)

void	AddItemToBoxList (const TArray< FResultStatData > &InDataList)

void	OnHideTutorialMessage ()

void	OnShowTutorialMessage (const FText &NewMessage)

void	OnTutorMessage (const FText &NewMessage)
	튜터 메시지를 설정하고 애니메이션을 재생합니다.

Protected 멤버 함수
virtual void	NativeConstruct () override
	위젯 초기화

Protected 속성
TObjectPtr< class UHorizontalBox >	ItemHorizontalBox
	아이템 표시용 HorizontalBox

TObjectPtr< class UWidgetAnimation >	TutorHideAnim
	TutorMessage Hide Animation (MainWidget에서 제어)

TObjectPtr< class UTutorMessage >	TutorMessage
	튜터 메시지 위젯 (옵션, BindWidgetOptional)

TObjectPtr< class UWidgetAnimation >	TutorShowAnim
	TutorMessage Show Animation (MainWidget에서 제어)

Private 멤버 함수
void	InitTutorMessage ()

void	OnTutorHideComplete ()
	TutorHideAnim 완료 시 호출되는 콜백

void	ProcessNextItem ()
	다음 아이템을 HorizontalBox에 추가 (타이머 콜백)

void	StartTutorHideTimer ()
	자동 Hide 타이머 시작

Private 속성
bool	bHasPendingMessage = false
	펜딩 메시지 존재 여부

bool	bIsTutorVisible = false
	튜터 메시지 표시 여부

bool	bPendingIsTutorial = false
	펜딩 메시지가 튜토리얼 메시지인지 여부

int32	CurItemIndex = 0
	현재 추가 중인 아이템 인덱스

float	ItemAddInterval = 0.1f
	아이템 추가 간격 (초)

FTimerHandle	ItemAddTimerHandle
	아이템 순차 추가 타이머 핸들

TSubclassOf< class UAutoDespawnItem >	ItemWidgetClass
	아이템 위젯 클래스

TArray< FResultStatData >	PendingItemDataList
	순차 추가 대기 중인 아이템 데이터 리스트

FText	PendingMessage
	펜딩 중인 메시지 (Hide 완료 후 표시할 메시지)

FTimerHandle	TutorHideTimerHandle
	자동 Hide 타이머 핸들

float	TutorMessageDisplayDuration = 3.0f
	튜터 메시지 표시 지속 시간 (초)

상세한 설명

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

멤버 함수 문서화

◆ AddItemToBoxItem()

void UToastWidget::AddItemToBoxItem ( const FResultStatData & InData )

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

{
    if (!ItemHorizontalBox || !ItemWidgetClass )
        return;
 
    // 새 아이템 생성
    if (auto SpawnItem = CreateWidget<UAutoDespawnItem>(GetWorld(), ItemWidgetClass))
    {
        ItemHorizontalBox->AddChild(SpawnItem);
 
        SpawnItem->InitData(InData);
    }
}

다음을 참조함 : ItemHorizontalBox, ItemWidgetClass.

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

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

◆ AddItemToBoxList()

void UToastWidget::AddItemToBoxList ( const TArray< FResultStatData > & InDataList )

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

{
    if (InDataList.Num() == 0)
        return;
 
    // 기존 타이머가 있으면 클리어
    if (ItemAddTimerHandle.IsValid())
    {
        GetWorld()->GetTimerManager().ClearTimer(ItemAddTimerHandle);
    }
 
    // 대기 리스트에 데이터 복사 및 인덱스 초기화
    PendingItemDataList = InDataList;
    CurItemIndex = 0;
 
    // 첫 번째 아이템은 즉시 추가
    ProcessNextItem();
}

다음을 참조함 : CurItemIndex, ItemAddTimerHandle, PendingItemDataList, ProcessNextItem().

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

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

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

◆ InitTutorMessage()

void UToastWidget::InitTutorMessage ( )

private

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

{
    if (TutorMessage)
    {
        TutorMessage->SetVisibility(ESlateVisibility::HitTestInvisible);
        
        FWidgetAnimationDynamicEvent HideDelegate;
        HideDelegate.BindDynamic(this, &UToastWidget::OnTutorHideComplete);
        BindToAnimationFinished(TutorHideAnim, HideDelegate);
 
        PlayAnimation(TutorHideAnim);
        
        bIsTutorVisible = false;
    }
}

다음을 참조함 : bIsTutorVisible, OnTutorHideComplete(), TutorHideAnim, TutorMessage.

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

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

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

◆ NativeConstruct()

void UToastWidget::NativeConstruct ( )

overrideprotectedvirtual

위젯 초기화

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

{
    if (auto BM = UBroadcastManager::Get(GetWorld()))
    {
        BM->OnTutorMessage.AddDynamic(this, &UToastWidget::OnTutorMessage);
        BM->OnAddItemToBoxList.AddDynamic(this, &UToastWidget::AddItemToBoxList);
 
        BM->OnShowTutorialMessage.AddDynamic(this, &UToastWidget::OnShowTutorialMessage);
        BM->OnHideTutorialMessage.AddDynamic(this, &UToastWidget::OnHideTutorialMessage);
    }
 
    // TutorMessage 초기화 및 애니메이션 콜백 바인딩
    InitTutorMessage();
}

다음을 참조함 : AddItemToBoxList(), InitTutorMessage(), OnHideTutorialMessage(), OnShowTutorialMessage(), OnTutorMessage().

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

◆ OnHideTutorialMessage()

void UToastWidget::OnHideTutorialMessage ( )

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

{
    if (!TutorMessage || !bIsTutorVisible) return;
 
    // 기존 타이머가 있으면 클리어
    if (TutorHideTimerHandle.IsValid())
    {
        GetWorld()->GetTimerManager().ClearTimer(TutorHideTimerHandle);
    }
 
    // Hide 애니메이션 재생
    if (TutorHideAnim)
    {
        PlayAnimation(TutorHideAnim);
    }
}

다음을 참조함 : bIsTutorVisible, TutorHideAnim, TutorHideTimerHandle, TutorMessage.

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

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

◆ OnShowTutorialMessage()

void UToastWidget::OnShowTutorialMessage ( const FText & NewMessage )

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

{
    if (!TutorMessage)
        return;
 
    // 기존 타이머가 있으면 클리어
    if (TutorHideTimerHandle.IsValid())
    {
        GetWorld()->GetTimerManager().ClearTimer(TutorHideTimerHandle);
    }
 
    if (bIsTutorVisible)
    {
        // 표시 중이면 Hide → SetText → Show
        PendingMessage = NewMessage;
        bHasPendingMessage = true;
        bPendingIsTutorial = true;
        
        PlayAnimation(TutorHideAnim);
    }
    else
    {
        // 숨김 상태면 바로 SetText → Show
        TutorMessage->SetMessageText(NewMessage);
        
        if (TutorShowAnim)
        {
            PlayAnimation(TutorShowAnim);
            bIsTutorVisible = true;
        }
    }
}

다음을 참조함 : bHasPendingMessage, bIsTutorVisible, bPendingIsTutorial, PendingMessage, TutorHideAnim, TutorHideTimerHandle, TutorMessage, TutorShowAnim.

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

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

◆ OnTutorHideComplete()

void UToastWidget::OnTutorHideComplete ( )

private

TutorHideAnim 완료 시 호출되는 콜백

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

{
    bIsTutorVisible = false;
    
    if (bHasPendingMessage && TutorMessage)
    {
        bHasPendingMessage = false;
        TutorMessage->SetMessageText(PendingMessage);
        
        if (TutorShowAnim)
        {
            PlayAnimation(TutorShowAnim);
            bIsTutorVisible = true;
 
            // 튜토리얼 메시지가 아닐 때만 타이머 시작!                                                                                                                                                                 
            if (!bPendingIsTutorial)  // ← 이 줄 추가!                                                                                                                                                                  
            {
                StartTutorHideTimer();
            }
        }
 
        // 플래그 초기화                                                                                                                                                                                                    
        bPendingIsTutorial = false;
    }
}

다음을 참조함 : bHasPendingMessage, bIsTutorVisible, bPendingIsTutorial, PendingMessage, StartTutorHideTimer(), TutorMessage, TutorShowAnim.

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

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

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

◆ OnTutorMessage()

void UToastWidget::OnTutorMessage ( const FText & NewMessage )

튜터 메시지를 설정하고 애니메이션을 재생합니다.

매개변수

NewMessage 표시할 메시지

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

{
    if (!TutorMessage)
        return;
 
    // 기존 타이머가 있으면 클리어
    if (TutorHideTimerHandle.IsValid())
    {
        GetWorld()->GetTimerManager().ClearTimer(TutorHideTimerHandle);
    }
 
    if (bIsTutorVisible)
    {
        // 표시 중이면 Hide → SetText → Show
        PendingMessage = NewMessage;
        bHasPendingMessage = true;
        bPendingIsTutorial = false; 
        
        PlayAnimation(TutorHideAnim);
    }
    else
    {
        // 숨김 상태면 바로 SetText → Show
        TutorMessage->SetMessageText(NewMessage);
        
        if (TutorShowAnim)
        {
            PlayAnimation(TutorShowAnim);
            bIsTutorVisible = true;
 
            // 자동 Hide 타이머 시작
            StartTutorHideTimer();
        }
    }
}

다음을 참조함 : bHasPendingMessage, bIsTutorVisible, bPendingIsTutorial, PendingMessage, StartTutorHideTimer(), TutorHideAnim, TutorHideTimerHandle, TutorMessage, TutorShowAnim.

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

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

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

◆ ProcessNextItem()

void UToastWidget::ProcessNextItem ( )

private

다음 아이템을 HorizontalBox에 추가 (타이머 콜백)

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

{
    if (CurItemIndex >= PendingItemDataList.Num())
    {
        // 모든 아이템 추가 완료
        PendingItemDataList.Empty();
        CurItemIndex = 0;
        return;
    }
 
    // 현재 인덱스의 아이템 추가
    AddItemToBoxItem(PendingItemDataList[CurItemIndex]);
    CurItemIndex++;
 
    // 다음 아이템이 있으면 타이머 설정
    if (CurItemIndex < PendingItemDataList.Num())
    {
        GetWorld()->GetTimerManager().SetTimer(
            ItemAddTimerHandle,
            this,
            &UToastWidget::ProcessNextItem,
            ItemAddInterval,
            false
        );
    }
    else
    {
        // 모든 아이템 추가 완료
        PendingItemDataList.Empty();
        CurItemIndex = 0;
    }
}

다음을 참조함 : AddItemToBoxItem(), CurItemIndex, ItemAddInterval, ItemAddTimerHandle, PendingItemDataList, ProcessNextItem().

다음에 의해서 참조됨 : AddItemToBoxList(), ProcessNextItem().

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

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

◆ StartTutorHideTimer()

void UToastWidget::StartTutorHideTimer ( )

private

자동 Hide 타이머 시작

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

{
    // 기존 타이머 클리어 (안전성을 위해)
    if (TutorHideTimerHandle.IsValid())
    {
        GetWorld()->GetTimerManager().ClearTimer(TutorHideTimerHandle);
    }
 
    // 지정된 시간 후 자동으로 Hide 애니메이션 재생
    GetWorld()->GetTimerManager().SetTimer(
        TutorHideTimerHandle,
        [this]()
        {
            if (bIsTutorVisible)
            {
                PlayAnimation(TutorHideAnim);
            }
        },
        TutorMessageDisplayDuration,
        false
    );
}

다음을 참조함 : bIsTutorVisible, TutorHideAnim, TutorHideTimerHandle, TutorMessageDisplayDuration.

다음에 의해서 참조됨 : OnTutorHideComplete(), OnTutorMessage().

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

멤버 데이터 문서화

◆ bHasPendingMessage

bool UToastWidget::bHasPendingMessage = false

private

펜딩 메시지 존재 여부

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

다음에 의해서 참조됨 : OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage().

◆ bIsTutorVisible

bool UToastWidget::bIsTutorVisible = false

private

튜터 메시지 표시 여부

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

다음에 의해서 참조됨 : InitTutorMessage(), OnHideTutorialMessage(), OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage(), StartTutorHideTimer().

◆ bPendingIsTutorial

bool UToastWidget::bPendingIsTutorial = false

private

펜딩 메시지가 튜토리얼 메시지인지 여부

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

다음에 의해서 참조됨 : OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage().

◆ CurItemIndex

int32 UToastWidget::CurItemIndex = 0

private

현재 추가 중인 아이템 인덱스

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

다음에 의해서 참조됨 : AddItemToBoxList(), ProcessNextItem().

◆ ItemAddInterval

float UToastWidget::ItemAddInterval = 0.1f

private

아이템 추가 간격 (초)

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

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

◆ ItemAddTimerHandle

FTimerHandle UToastWidget::ItemAddTimerHandle

private

아이템 순차 추가 타이머 핸들

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

다음에 의해서 참조됨 : AddItemToBoxList(), ProcessNextItem().

◆ ItemHorizontalBox

TObjectPtr<class UHorizontalBox> UToastWidget::ItemHorizontalBox

protected

아이템 표시용 HorizontalBox

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

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

◆ ItemWidgetClass

TSubclassOf<class UAutoDespawnItem> UToastWidget::ItemWidgetClass

private

아이템 위젯 클래스

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

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

◆ PendingItemDataList

TArray<FResultStatData> UToastWidget::PendingItemDataList

private

순차 추가 대기 중인 아이템 데이터 리스트

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

다음에 의해서 참조됨 : AddItemToBoxList(), ProcessNextItem().

◆ PendingMessage

FText UToastWidget::PendingMessage

private

펜딩 중인 메시지 (Hide 완료 후 표시할 메시지)

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

다음에 의해서 참조됨 : OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage().

◆ TutorHideAnim

TObjectPtr<class UWidgetAnimation> UToastWidget::TutorHideAnim

protected

TutorMessage Hide Animation (MainWidget에서 제어)

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

다음에 의해서 참조됨 : InitTutorMessage(), OnHideTutorialMessage(), OnShowTutorialMessage(), OnTutorMessage(), StartTutorHideTimer().

◆ TutorHideTimerHandle

FTimerHandle UToastWidget::TutorHideTimerHandle

private

자동 Hide 타이머 핸들

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

다음에 의해서 참조됨 : OnHideTutorialMessage(), OnShowTutorialMessage(), OnTutorMessage(), StartTutorHideTimer().

◆ TutorMessage

TObjectPtr<class UTutorMessage> UToastWidget::TutorMessage

protected

튜터 메시지 위젯 (옵션, BindWidgetOptional)

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

다음에 의해서 참조됨 : InitTutorMessage(), OnHideTutorialMessage(), OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage().

◆ TutorMessageDisplayDuration

float UToastWidget::TutorMessageDisplayDuration = 3.0f

private

튜터 메시지 표시 지속 시간 (초)

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

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

◆ TutorShowAnim

TObjectPtr<class UWidgetAnimation> UToastWidget::TutorShowAnim

protected

TutorMessage Show Animation (MainWidget에서 제어)

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

다음에 의해서 참조됨 : OnShowTutorialMessage(), OnTutorHideComplete(), OnTutorMessage().

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

Source/Onepiece/UI/Public/UToastWidget.h
Source/Onepiece/UI/Private/UToastWidget.cpp

Public 멤버 함수

Protected 멤버 함수

Protected 속성

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ AddItemToBoxItem()

◆ AddItemToBoxList()

◆ InitTutorMessage()

◆ NativeConstruct()

◆ OnHideTutorialMessage()

◆ OnShowTutorialMessage()

◆ OnTutorHideComplete()

◆ OnTutorMessage()

◆ ProcessNextItem()

◆ StartTutorHideTimer()

멤버 데이터 문서화

◆ bHasPendingMessage

◆ bIsTutorVisible

◆ bPendingIsTutorial

◆ CurItemIndex

◆ ItemAddInterval

◆ ItemAddTimerHandle

◆ ItemHorizontalBox

◆ ItemWidgetClass

◆ PendingItemDataList

◆ PendingMessage

◆ TutorHideAnim

◆ TutorHideTimerHandle

◆ TutorMessage

◆ TutorMessageDisplayDuration

◆ TutorShowAnim