UTutorialPopupWidget 클래스 참조

#include <TutorialPopupWidget.h>

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

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

Public 멤버 함수
virtual void	OnPushedToLayer () override
virtual void	OnActivated () override
virtual void	OnDeactivated () override
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
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

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativeDestruct () override
void	CreateTutorialContents (const TArray< FDT_TutorialTable > &Table)
void	AddTutorialContent (UTutorialContentWidget *ContentWidget)
void	RemoveTutorialContent (UTutorialContentWidget *ContentWidget)
void	DisplayTutorialContent (UTutorialContentWidget *ContentWidget)
void	DisplayFirstTutorialContent ()
void	ClearTutorialContents ()
TArray< FDT_TutorialTable >	BuildTutorialRows () const
void	OnTutorialContentClicked (UTutorialContentWidget *ContentWidget)
void	OnCloseButtonClicked ()
UPopupWidgetBase(으)로부터 상속된 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 ()

Protected 속성
TSubclassOf< UTutorialContentWidget >	TutorialContentWidgetClass
TObjectPtr< UMediaPlayer >	TutorialMediaPlayer
TObjectPtr< UMaterialInterface >	TutorialVideoMaterial
TObjectPtr< UScrollBox >	SB_TutorialContentList
TObjectPtr< UImage >	IMG_TutorialVideo
TObjectPtr< UTextBlock >	TXT_DescriptionBoxTitle
TObjectPtr< UTextBlock >	TXT_Description
TObjectPtr< UButton >	BTN_CloseButton
UUserWidgetBase(으)로부터 상속된 Protected 속성
EWidgetState	WidgetState
TObjectPtr< UAbilitySystemComponent >	ASC
FGameplayTag	LayerTag
bool	bPrimary = false
TObjectPtr< UWidgetAnimation >	AppearanceAnim
TObjectPtr< UWidgetAnimation >	DisappearanceAnim

Private 속성
TArray< TObjectPtr< UTutorialContentWidget > >	TutorialContentWidgets

추가로 상속된 멤버들
UPopupWidgetBase(으)로부터 상속된 Public 속성
FOnPopupClosed	OnPopupClosed

멤버 함수 문서화

AddTutorialContent()

void UTutorialPopupWidget::AddTutorialContent ( UTutorialContentWidget *  ContentWidget )

protected

{
    if (ContentWidget == nullptr)
    {
        LOG_ERROR(LogCK, "%s가 nullptr입니다.", NAMEOF(UTutorialContentWidget));
        return;
    }
 
    if (SB_TutorialContentList == nullptr)
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(SB_TutorialContentList));
        return;
    }
 
    SB_TutorialContentList->AddChild(ContentWidget);
    TutorialContentWidgets.Add(ContentWidget);
}

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

BuildTutorialRows()

TArray< FDT_TutorialTable > UTutorialPopupWidget::BuildTutorialRows ( ) const

protected

{
    TArray<FDT_TutorialTable> Result;
 
    UStageManifest* StageManifest = UDataBundleRegistry::GetBundleAssetByTag<UStageManifest>(TAG_BUNDLE_INITIAL);
 
    if (StageManifest == nullptr)
    {
        LOG_WARNING(LogCK, "%s를 찾을 수 없어 튜토리얼 데이터를 만들 수 없습니다.", NAMEOF(UStageManifest));
        return Result;
    }
 
    const UDataTable* TutorialTable = StageManifest->TutorialDataMap.LoadSynchronous();
 
    if (TutorialTable == nullptr)
    {
        LOG_WARNING(LogCK, "TutorialDataMap 로드 실패: DataTable이 nullptr입니다.");
        return Result;
    }
 
    TArray<FDT_TutorialTable*> TutorialRows;
    TutorialTable->GetAllRows(TEXT("UTutorialPopupWidget::BuildTutorialRows"), TutorialRows);
 
    for (const FDT_TutorialTable* Row : TutorialRows)
    {
        if (Row)
        {
            Result.Add(*Row);
        }
    }
 
    Result.Sort([](const FDT_TutorialTable& Left, const FDT_TutorialTable& Right)
    {
        return Left.Tutorial_ID < Right.Tutorial_ID;
    });
 
    if (Result.IsEmpty())
    {
        LOG_WARNING(LogCK, "튜토리얼 데이터가 없습니다.");
    }
 
    return Result;
}

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

ClearTutorialContents()

void UTutorialPopupWidget::ClearTutorialContents ( )

protected

{
    for (UTutorialContentWidget* ContentWidget : TutorialContentWidgets)
    {
        if (ContentWidget)
        {
            ContentWidget->OnTutorialContentClicked.RemoveAll(this);
        }
    }
 
    TutorialContentWidgets.Empty();
 
    if (SB_TutorialContentList)
    {
        SB_TutorialContentList->ClearChildren();
    }
}

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

CreateTutorialContents()

void UTutorialPopupWidget::CreateTutorialContents ( const TArray< FDT_TutorialTable > &  Table )

protected

{
    ClearTutorialContents();
 
    if (SB_TutorialContentList == nullptr)
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(SB_TutorialContentList));
        return;
    }
 
    if (TutorialContentWidgetClass == nullptr)
    {
        LOG_ERROR(LogCK, "%s가 설정되지 않았습니다.", NAMEOF_VAR(TutorialContentWidgetClass));
        return;
    }
 
    for (const FDT_TutorialTable& TutorialRow : Table)
    {
        UTutorialContentWidget* ContentWidget = CreateWidget<UTutorialContentWidget>(GetOwningPlayer(), TutorialContentWidgetClass);
 
        if (ContentWidget == nullptr)
        {
            LOG_ERROR(LogCK, "%s 생성에 실패했습니다.", NAMEOF(UTutorialContentWidget));
            continue;
        }
 
        ContentWidget->InitializeTutorialContent(TutorialRow);
        ContentWidget->OnTutorialContentClicked.AddDynamic(this, &UTutorialPopupWidget::OnTutorialContentClicked);
        AddTutorialContent(ContentWidget);
    }
 
    DisplayFirstTutorialContent();
}

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

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

DisplayFirstTutorialContent()

void UTutorialPopupWidget::DisplayFirstTutorialContent ( )

protected

{
    if (TutorialContentWidgets.IsEmpty() == false)
    {
        DisplayTutorialContent(TutorialContentWidgets[0]);
        return;
    }
    
    if (TutorialMediaPlayer)
    {
        TutorialMediaPlayer->Close();
    }
 
    if (IMG_TutorialVideo)
    {
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Collapsed);
    }
}

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

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

DisplayTutorialContent()

void UTutorialPopupWidget::DisplayTutorialContent ( UTutorialContentWidget *  ContentWidget )

protected

{
    if (ContentWidget == nullptr)
    {
        return;
    }
 
    const FDT_TutorialTable& TutorialData = ContentWidget->GetTutorialData();
 
    if (TXT_DescriptionBoxTitle)
    {
        TXT_DescriptionBoxTitle->SetText(TutorialData.Title);
    }
    else
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(TXT_DescriptionBoxTitle));
    }
 
    if (TXT_Description)
    {
        TXT_Description->SetText(TutorialData.Description);
    }
    else
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(TXT_Description));
    }
 
    if (IMG_TutorialVideo == nullptr)
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(IMG_TutorialVideo));
        return;
    }
 
    if (TutorialMediaPlayer == nullptr)
    {
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Collapsed);
        LOG_ERROR(LogCK, "%s가 설정되지 않았습니다.", NAMEOF_VAR(TutorialMediaPlayer));
        return;
    }
 
    const FString VideoPath = TutorialData.VideoPath.ToString();
 
    if (VideoPath.IsEmpty())
    {
        TutorialMediaPlayer->Close();
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Collapsed);
        return;
    }
 
    UMediaSource* TutorialMediaSource = LoadObject<UMediaSource>(nullptr, *VideoPath);
 
    if (IsValid(TutorialMediaSource) == false)
    {
        TutorialMediaPlayer->Close();
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Collapsed);
        LOG_WARNING(LogCK, "Tutorial media source 로드 실패: %s", *VideoPath);
        return;
    }
 
    if (TutorialVideoMaterial)
    {
        IMG_TutorialVideo->SetBrushFromMaterial(TutorialVideoMaterial);
    }
 
    TutorialMediaPlayer->Close();
    TutorialMediaPlayer->PlayOnOpen = true;
    TutorialMediaPlayer->SetLooping(true);
 
    if (TutorialMediaPlayer->OpenSource(TutorialMediaSource))
    {
        TutorialMediaPlayer->Play();
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Visible);
    }
    else
    {
        TutorialMediaPlayer->Close();
        IMG_TutorialVideo->SetVisibility(ESlateVisibility::Collapsed);
        LOG_WARNING(LogCK, "Tutorial media source 재생 실패: %s", *VideoPath);
    }
}

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

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

NativeConstruct()

void UTutorialPopupWidget::NativeConstruct ( )

overrideprotectedvirtual

{
    Super::NativeConstruct();
 
    if (IMG_TutorialVideo && TutorialVideoMaterial)
    {
        IMG_TutorialVideo->SetBrushFromMaterial(TutorialVideoMaterial);
    }
 
    if (BTN_CloseButton)
    {
        BTN_CloseButton->OnClicked.AddDynamic(this, &UTutorialPopupWidget::OnCloseButtonClicked);
    }
    else
    {
        LOG_ERROR(LogCK, "%s 바인딩이 없습니다.", NAMEOF_VAR(BTN_CloseButton));
    }
}

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

NativeDestruct()

void UTutorialPopupWidget::NativeDestruct ( )

overrideprotectedvirtual

{
    if (TutorialMediaPlayer)
    {
        TutorialMediaPlayer->Close();
    }
 
    if (BTN_CloseButton)
    {
        BTN_CloseButton->OnClicked.RemoveAll(this);
    }
 
    ClearTutorialContents();
    Super::NativeDestruct();
}

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

OnActivated()

void UTutorialPopupWidget::OnActivated ( )

overridevirtual

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

{
    Super::OnActivated();
}

OnCloseButtonClicked()

void UTutorialPopupWidget::OnCloseButtonClicked ( )

protected

{
    if (TutorialMediaPlayer)
    {
        TutorialMediaPlayer->Close();
    }
 
    ClearTutorialContents();
 
    if (UUIManagementSubsystem* UISubsystem = UCK_BPFunctionLibrary::GetUIManagementSubsystem(this))
    {
        UISubsystem->PopWidget(this);
    }
    else
    {
        LOG_WARNING(LogCK, "%s을 찾지 못해 직접 RemoveFromParent 합니다.", NAMEOF(UUIManagementSubsystem));
        RemoveFromParent();
    }
}

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

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

OnDeactivated()

void UTutorialPopupWidget::OnDeactivated ( )

overridevirtual

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

{
    if (TutorialMediaPlayer)
    {
        TutorialMediaPlayer->Close();
    }
 
    ClearTutorialContents();
    Super::OnDeactivated();
}

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

OnPushedToLayer()

void UTutorialPopupWidget::OnPushedToLayer ( )

overridevirtual

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

{
    Super::OnPushedToLayer();
    CreateTutorialContents(BuildTutorialRows());
}

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

OnTutorialContentClicked()

void UTutorialPopupWidget::OnTutorialContentClicked ( UTutorialContentWidget *  ContentWidget )

protected

{
    DisplayTutorialContent(ContentWidget);
}

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

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

RemoveTutorialContent()

void UTutorialPopupWidget::RemoveTutorialContent ( UTutorialContentWidget *  ContentWidget )

protected

{
    if (ContentWidget == nullptr)
    {
        return;
    }
 
    ContentWidget->OnTutorialContentClicked.RemoveAll(this);
    TutorialContentWidgets.Remove(ContentWidget);
 
    if (SB_TutorialContentList)
    {
        ContentWidget->RemoveFromParent();
    }
}

멤버 데이터 문서화

BTN_CloseButton

TObjectPtr<UButton> UTutorialPopupWidget::BTN_CloseButton

protected

IMG_TutorialVideo

TObjectPtr<UImage> UTutorialPopupWidget::IMG_TutorialVideo

protected

SB_TutorialContentList

TObjectPtr<UScrollBox> UTutorialPopupWidget::SB_TutorialContentList

protected

TutorialContentWidgetClass

TSubclassOf<UTutorialContentWidget> UTutorialPopupWidget::TutorialContentWidgetClass

protected

TutorialContentWidgets

TArray<TObjectPtr<UTutorialContentWidget> > UTutorialPopupWidget::TutorialContentWidgets

private

TutorialMediaPlayer

TObjectPtr<UMediaPlayer> UTutorialPopupWidget::TutorialMediaPlayer

protected

TutorialVideoMaterial

TObjectPtr<UMaterialInterface> UTutorialPopupWidget::TutorialVideoMaterial

protected

TXT_Description

TObjectPtr<UTextBlock> UTutorialPopupWidget::TXT_Description

protected

TXT_DescriptionBoxTitle

TObjectPtr<UTextBlock> UTutorialPopupWidget::TXT_DescriptionBoxTitle

protected

---

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

• Source/CK_UE/UI/Popup/Tutorial/TutorialPopupWidget.h
• Source/CK_UE/UI/Popup/Tutorial/TutorialPopupWidget.cpp