특정 WordType의 단어 아이템들을 그룹으로 묶어서 표시하는 위젯 더 자세히 ...

#include <ULevelWordGroup.h>

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

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

Public 멤버 함수
void	InitGroup (EWordType InWordType, int32 InCurrentLevel)
	그룹 정보를 초기화하고 아이템들을 생성

void	SetColumnCount (int32 InColumnCount)
	그리드에 표시할 열의 개수를 설정

Public 속성
TObjectPtr< class UImage >	Image_Symbol
	그룹 심볼 이미지

TObjectPtr< class UTextBlock >	Text_GroupName
	그룹 이름 텍스트

TObjectPtr< class UUniformGridPanel >	UniformGridPanel
	아이템들이 배치될 Uniform Grid Panel

Protected 멤버 함수
void	PopulateItems ()
	아이템들을 Uniform Grid Panel에 배치

void	UpdateGroupTitle ()
	그룹 타이틀을 업데이트

Protected 속성
int32	ColumnCount = 2
	그리드 열 개수 (기본값: 2)

int32	CurrentLevel = 1
	현재 선택된 레벨

TSubclassOf< class ULevelWordItem >	LevelWordItemClass
	생성할 아이템 위젯 클래스

EWordType	WordType
	현재 그룹의 단어 타입

상세한 설명

특정 WordType의 단어 아이템들을 그룹으로 묶어서 표시하는 위젯

Uniform Grid Panel에 ULevelWordItem들을 배치하여 단어 그룹을 시각화

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

멤버 함수 문서화

◆ InitGroup()

void ULevelWordGroup::InitGroup	(	EWordType	InWordType,
		int32	InCurrentLevel
	)

그룹 정보를 초기화하고 아이템들을 생성

매개변수

InWordType	단어 타입 (Animal, Color, Region, Food)
InCurrentLevel	현재 선택된 레벨 (이 레벨 이하의 모든 단어를 표시)

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

{
    WordType = InWordType;
    CurrentLevel = InCurrentLevel;
 
    UpdateGroupTitle();
    PopulateItems();
}

다음을 참조함 : CurrentLevel, PopulateItems(), UpdateGroupTitle(), WordType.

다음에 의해서 참조됨 : ULevelSelectItem::CreateAnimalGroup(), ULevelSelectItem::CreateColorGroup(), ULevelSelectItem::CreateFoodGroup(), ULevelSelectItem::CreateRegionGroup().

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

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

◆ PopulateItems()

void ULevelWordGroup::PopulateItems ( )

protected

아이템들을 Uniform Grid Panel에 배치

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

{
    if (!UniformGridPanel || !LevelWordItemClass)
    {
        return;
    }
 
    UGameDataManager* GameDataManager = UGameDataManager::Get(GetWorld());
    if (!GameDataManager)
    {
        return;
    }
 
    // 기존 아이템들 제거
    UniformGridPanel->ClearChildren();
 
    // 레벨별 단어 데이터를 수집하는 구조체
    struct FWordItemData
    {
        int32 WordCode;
        int32 Level;
        bool bIsCurrentLevel;
    };
 
    TArray<FWordItemData> AllWordData;
 
    // WordType에 따라 현재 레벨 이하의 모든 데이터 수집
    if (WordType == EWordType::Animal)
    {
        // FReadData에서 CurrentLevel 이하의 모든 데이터 가져오기
        for (int32 Level = 1; Level <= CurrentLevel; ++Level)
        {
            TArray<FReadData> ReadDataArray = GameDataManager->GetReadDataByLevel(Level);
            for (const FReadData& ReadData : ReadDataArray)
            {
                FWordItemData ItemData;
                ItemData.WordCode = ReadData.Index;
                ItemData.Level = Level;
                ItemData.bIsCurrentLevel = (Level == CurrentLevel);
                AllWordData.Add(ItemData);
            }
        }
    }
    else if (WordType == EWordType::Color)
    {
        // FColorData에서 CurrentLevel 이하의 모든 데이터 가져오기
        for (int32 Level = 1; Level <= CurrentLevel; ++Level)
        {
            TArray<FColorData> ColorDataArray = GameDataManager->GetColorDataByLevel(Level);
            for (const FColorData& ColorData : ColorDataArray)
            {
                FWordItemData ItemData;
                ItemData.WordCode = ColorData.Index;
                ItemData.Level = Level;
                ItemData.bIsCurrentLevel = (Level == CurrentLevel);
                AllWordData.Add(ItemData);
            }
        }
    }
    else if (WordType == EWordType::Region)
    {
        // FListenData (Category="Region")에서 CurrentLevel 이하의 모든 데이터 가져오기
        TArray<FListenData> ListenDataArray = GameDataManager->GetListenDataByCategory(TEXT("Region"));
        for (const FListenData& ListenData : ListenDataArray)
        {
            if (ListenData.Level >= 1 && ListenData.Level <= CurrentLevel)
            {
                FWordItemData ItemData;
                ItemData.WordCode = ListenData.Index;
                ItemData.Level = ListenData.Level;
                ItemData.bIsCurrentLevel = (ListenData.Level == CurrentLevel);
                AllWordData.Add(ItemData);
            }
        }
    }
    else if (WordType == EWordType::Food)
    {
        // FListenData (Category="Food")에서 CurrentLevel 이하의 모든 데이터 가져오기
        TArray<FListenData> ListenDataArray = GameDataManager->GetListenDataByCategory(TEXT("Food"));
        for (const FListenData& ListenData : ListenDataArray)
        {
            if (ListenData.Level >= 1 && ListenData.Level <= CurrentLevel)
            {
                FWordItemData ItemData;
                ItemData.WordCode = ListenData.Index;
                ItemData.Level = ListenData.Level;
                ItemData.bIsCurrentLevel = (ListenData.Level == CurrentLevel);
                AllWordData.Add(ItemData);
            }
        }
    }
 
    // Level 내림차순으로 정렬 (3 -> 2 -> 1)
    AllWordData.Sort([](const FWordItemData& A, const FWordItemData& B)
    {
        return A.Level > B.Level;
    });
 
    // 아이템 생성 및 배치
    for (int32 i = 0; i < AllWordData.Num(); ++i)
    {
        const FWordItemData& ItemData = AllWordData[i];
 
        // ULevelWordItem 생성
        ULevelWordItem* WordItem = CreateWidget<ULevelWordItem>(this, LevelWordItemClass);
        if (!WordItem)
        {
            continue;
        }
 
        // 아이템 초기화
        WordItem->InitInfo(WordType, ItemData.WordCode);
 
        // 색상 설정 (현재 레벨: 녹색, 하위 레벨: 회색)
        WordItem->SetItemColor(ItemData.bIsCurrentLevel);
 
        // 그리드 위치 계산
        int32 Row = i / ColumnCount;
        int32 Column = i % ColumnCount;
 
        // UniformGridPanel에 추가
        UUniformGridSlot* GridSlot = UniformGridPanel->AddChildToUniformGrid(WordItem, Row, Column);
        if (GridSlot)
        {
            GridSlot->SetHorizontalAlignment(HAlign_Fill);
            GridSlot->SetVerticalAlignment(VAlign_Fill);
        }
    }
}

다음을 참조함 : Animal, Color, ColumnCount, CurrentLevel, Food, UGameDataManager::GetColorDataByLevel(), UGameDataManager::GetListenDataByCategory(), UGameDataManager::GetReadDataByLevel(), ULevelWordItem::InitInfo(), LevelWordItemClass, Region, ULevelWordItem::SetItemColor(), UniformGridPanel, WordType.

다음에 의해서 참조됨 : InitGroup(), SetColumnCount().

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

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

◆ SetColumnCount()

void ULevelWordGroup::SetColumnCount ( int32 InColumnCount )

그리드에 표시할 열의 개수를 설정

매개변수

InColumnCount 열 개수

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

{
    if (InColumnCount > 0)
    {
        ColumnCount = InColumnCount;
 
        // 열 개수가 변경되면 아이템을 다시 배치
        PopulateItems();
    }
}

다음을 참조함 : ColumnCount, PopulateItems().

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

◆ UpdateGroupTitle()

void ULevelWordGroup::UpdateGroupTitle ( )

protected

그룹 타이틀을 업데이트

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

{
    if (!Text_GroupName)
    {
        return;
    }
 
    FString GroupName;
    switch (WordType)
    {
    case EWordType::Animal:     GroupName = TEXT("Animal");     break;
    case EWordType::Color:      GroupName = TEXT("Color");      break;
    case EWordType::Region:     GroupName = TEXT("Region");     break;
    case EWordType::Food:       GroupName = TEXT("Food");       break;
    default:
        GroupName = TEXT("Unknown");
        break;
    }
 
    Text_GroupName->SetText(FText::FromString(GroupName));
}

다음을 참조함 : Animal, Color, Food, Region, Text_GroupName, WordType.

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

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

멤버 데이터 문서화

◆ ColumnCount

int32 ULevelWordGroup::ColumnCount = 2

protected

그리드 열 개수 (기본값: 2)

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

다음에 의해서 참조됨 : PopulateItems(), SetColumnCount().

◆ CurrentLevel

int32 ULevelWordGroup::CurrentLevel = 1

protected

현재 선택된 레벨

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

다음에 의해서 참조됨 : InitGroup(), PopulateItems().

◆ Image_Symbol

TObjectPtr<class UImage> ULevelWordGroup::Image_Symbol

그룹 심볼 이미지

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

◆ LevelWordItemClass

TSubclassOf<class ULevelWordItem> ULevelWordGroup::LevelWordItemClass

protected

생성할 아이템 위젯 클래스

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

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

◆ Text_GroupName

TObjectPtr<class UTextBlock> ULevelWordGroup::Text_GroupName

그룹 이름 텍스트

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

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

◆ UniformGridPanel

TObjectPtr<class UUniformGridPanel> ULevelWordGroup::UniformGridPanel

아이템들이 배치될 Uniform Grid Panel

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

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

◆ WordType

EWordType ULevelWordGroup::WordType

protected

현재 그룹의 단어 타입

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

다음에 의해서 참조됨 : InitGroup(), PopulateItems(), UpdateGroupTitle().

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

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

Public 멤버 함수

Public 속성

Protected 멤버 함수

Protected 속성

상세한 설명

멤버 함수 문서화

◆ InitGroup()

◆ PopulateItems()

◆ SetColumnCount()

◆ UpdateGroupTitle()

멤버 데이터 문서화

◆ ColumnCount

◆ CurrentLevel

◆ Image_Symbol

◆ LevelWordItemClass

◆ Text_GroupName

◆ UniformGridPanel

◆ WordType