데이터를 기반으로 탭 버튼들을 동적으로 생성하고 관리하는 탭 그룹 위젯. 더 자세히 ...

#include <UTabButtonGroup.h>

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

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

Public 멤버 함수
	DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam (FOnTabSelected, int32, TabIndex)
	탭 선택 이벤트 델리게이트

FLinearColor	GetActivateColor (bool bSelect) const
	선택된 탭의 색상을 반환합니다.

FLinearColor	GetTextColor (bool bSelect) const
	선택된 탭의 색상을 반환합니다.

void	OnSelectTab (int32 TabIndex, bool bBroadcastEvent=true)
	특정 인덱스의 탭을 강제로 선택합니다.

Public 속성
FOnTabSelected	OnTabSelected
	탭 선택이 변경될 때 발생하는 이벤트

Protected 멤버 함수
void	ApplyTab ()
	TabLabels 데이터를 기반으로 탭 버튼들을 다시 생성하고 배치합니다.

virtual void	NativeConstruct () override

virtual void	NativePreConstruct () override

void	OnTabClicked (int32 TabIndex)
	탭 버튼 중 하나가 클릭되었을 때 호출될 내부 핸들러.

Protected 속성
FLinearColor	ActivateSelectColor = FLinearColor::White
	선택된 탭의 텍스트 색상.

FLinearColor	ActivateUnselectColor = FLinearColor(0.5f, 0.5f, 0.5f)
	비선택된 탭의 텍스트 색상.

bool	bAnimateIndicator = true
	선택 인디케이터의 이동 애니메이션 활성화 여부.

int32	DefaultTabIndex = 0
	위젯이 생성될 때 기본으로 선택될 탭의 인덱스.

float	IndicatorAnimationSpeed = 0.15f
	선택 인디케이터의 애니메이션 속도 (초 단위).

TSubclassOf< class UTabButton >	TabButtonClass
	탭 버튼으로 생성할 UTabButton 위젯 블루프린트 클래스.

TObjectPtr< class UHorizontalBox >	TabContainer
	생성된 탭 버튼들이 추가될 컨테이너. 블루프린트에서 'TabContainer' 이름으로 생성해야 합니다.

TObjectPtr< class UTabIndicator >	TabIndicator
	선택된 탭을 따라 움직이는 인디케이터 위젯. 블루프린트에서 'TabIndicator' 이름으로 생성해야 합니다.

TArray< FText >	TabLabels
	각 탭에 표시될 텍스트 라벨 배열. 이 배열의 크기에 따라 탭이 생성됩니다.

FVector2D	TabSize = FVector2D(300.0f, 75.0f)
	각 탭의 고정 크기 (Width × Height). TabIndicator 크기도 자동으로 이 값으로 설정됩니다.

FLinearColor	TextSelectColor = FLinearColor::White
	선택된 탭의 텍스트 색상.

FLinearColor	TextUnselectColor = FLinearColor(0.5f, 0.5f, 0.5f)
	비선택된 탭의 텍스트 색상.

Private 멤버 함수
void	OnMoveCompleted ()
	인디케이터 이동 완료 시 호출될 핸들러

void	UpdateIndicatorPosition ()
	선택 인디케이터의 위치를 현재 선택된 탭으로 업데이트합니다.

Private 속성
int32	CurTabIndex = -1
	현재 선택된 탭의 인덱스.

TArray< TObjectPtr< class UTabButton > >	TabButtonList
	동적으로 생성되어 현재 관리 중인 탭 버튼 위젯 인스턴스 배열.

상세한 설명

데이터를 기반으로 탭 버튼들을 동적으로 생성하고 관리하는 탭 그룹 위젯.

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

멤버 함수 문서화

◆ ApplyTab()

void UTabButtonGroup::ApplyTab ( )

protected

TabLabels 데이터를 기반으로 탭 버튼들을 다시 생성하고 배치합니다.

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

{
    // TabButtonClass 유효성 검사
    if (!TabButtonClass)
        return;
 
    // TabContainer 유효성 검사
    if (!TabContainer)
        return;
 
    // 기존 탭 버튼들 제거
    TabContainer->ClearChildren();
    TabButtonList.Empty();
 
    // TabLabels 배열을 순회하며 탭 버튼 생성
    for (int32 i = 0; i < TabLabels.Num(); ++i)
    {
        // UTabButton 인스턴스 생성
        UTabButton* newButton = CreateWidget<UTabButton>(this, TabButtonClass);
        if (!newButton)
            continue;
 
        // 버튼 초기화
        newButton->InitData(i, this);
        newButton->SetLabel(TabLabels[i]);
 
        // 클릭 이벤트 바인딩
        newButton->OnTabButtonClicked.RemoveDynamic(this, &UTabButtonGroup::OnTabClicked);
        newButton->OnTabButtonClicked.AddDynamic(this, &UTabButtonGroup::OnTabClicked);
 
        // HorizontalBox에 추가
        UHorizontalBoxSlot* slot = TabContainer->AddChildToHorizontalBox(newButton);
        if (slot)
        {
            // 슬롯 설정 (균등 분배)
            slot->SetHorizontalAlignment(HAlign_Fill);
            slot->SetVerticalAlignment(VAlign_Fill);
            slot->SetSize(FSlateChildSize(ESlateSizeRule::Fill));
        }
 
        // 인스턴스 배열에 추가
        TabButtonList.Add(newButton);
    }
}

다음을 참조함 : UTabButton::InitData(), UTabButton::OnTabButtonClicked, OnTabClicked(), UTabButton::SetLabel(), TabButtonClass, TabButtonList, TabContainer, TabLabels.

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

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

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

◆ DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam()

UTabButtonGroup::DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam	(	FOnTabSelected	,
		int32	,
		TabIndex
	)

탭 선택 이벤트 델리게이트

◆ GetActivateColor()

FLinearColor UTabButtonGroup::GetActivateColor ( bool bSelect ) const

inline

선택된 탭의 색상을 반환합니다.

반환값: 선택된 탭의 색상

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

    {
        if ( bSelect )
            return ActivateSelectColor;
        else
            return ActivateUnselectColor;
    }

◆ GetTextColor()

FLinearColor UTabButtonGroup::GetTextColor ( bool bSelect ) const

inline

선택된 탭의 색상을 반환합니다.

반환값: 선택된 탭의 색상

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

    {
        if ( bSelect )
            return TextSelectColor;
        else
            return TextUnselectColor;
    }

◆ NativeConstruct()

void UTabButtonGroup::NativeConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativeConstruct();
 
    // 인디케이터 이동 완료 이벤트 바인딩 및 설정
    if (TabIndicator)
    {
        TabIndicator->OnMoveCompleted.RemoveDynamic(this, &UTabButtonGroup::OnMoveCompleted);
        TabIndicator->OnMoveCompleted.AddDynamic(this, &UTabButtonGroup::OnMoveCompleted);
 
        // 애니메이션 속도 설정
        TabIndicator->SetAnimationSpeed(IndicatorAnimationSpeed);
 
        // TabIndicator 크기를 TabSize로 자동 설정
        UCanvasPanelSlot* indicatorSlot = Cast<UCanvasPanelSlot>(TabIndicator->Slot);
        if (indicatorSlot)
        {
            indicatorSlot->SetSize(TabSize);
        }
    }
 
    // 탭 구성
    ApplyTab();
 
    // 기본 탭 선택 (이벤트는 발생시키지 않음)
    OnSelectTab(DefaultTabIndex, false);
}

다음을 참조함 : ApplyTab(), DefaultTabIndex, IndicatorAnimationSpeed, OnMoveCompleted(), OnSelectTab(), TabIndicator, TabSize.

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

◆ NativePreConstruct()

void UTabButtonGroup::NativePreConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativePreConstruct();
 
    // 에디터 프리뷰를 위해 탭을 재구성
    ApplyTab();
}

다음을 참조함 : ApplyTab().

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

◆ OnMoveCompleted()

void UTabButtonGroup::OnMoveCompleted ( )

private

인디케이터 이동 완료 시 호출될 핸들러

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

{
    // 인디케이터 이동이 완료되었을 때 수행할 작업
    // 예: 사운드 재생, 추가 이벤트 발생 등
}

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

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

◆ OnSelectTab()

void UTabButtonGroup::OnSelectTab	(	int32	TabIndex,
		bool	bBroadcastEvent = `true`
	)

특정 인덱스의 탭을 강제로 선택합니다.

매개변수

[in]	TabIndex	선택할 탭의 인덱스
[in]	bBroadcastEvent	OnTabSelected 델리게이트를 호출할지 여부

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

{
    // 인덱스 유효성 검사
    if (!TabButtonList.IsValidIndex(TabIndex))
        return;
 
    // 이미 선택된 탭이면 무시
    if (CurTabIndex == TabIndex)
        return;
 
    // 현재 탭 인덱스 업데이트
    CurTabIndex = TabIndex;
 
    // 모든 탭 버튼의 선택 상태 업데이트
    for (int32 i = 0; i < TabButtonList.Num(); ++i)
    {
        if (TabButtonList[i])
        {
            TabButtonList[i]->SetSelected(i == CurTabIndex);
        }
    }
 
    // 인디케이터 위치 업데이트
    UpdateIndicatorPosition();
 
    // 이벤트 브로드캐스트
    if (bBroadcastEvent)
        OnTabSelected.Broadcast(CurTabIndex);
}

다음을 참조함 : CurTabIndex, OnTabSelected, TabButtonList, UpdateIndicatorPosition().

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

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

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

◆ OnTabClicked()

void UTabButtonGroup::OnTabClicked ( int32 TabIndex )

protected

탭 버튼 중 하나가 클릭되었을 때 호출될 내부 핸들러.

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

{
    OnSelectTab(TabIndex, true);
}

다음을 참조함 : OnSelectTab().

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

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

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

◆ UpdateIndicatorPosition()

void UTabButtonGroup::UpdateIndicatorPosition ( )

private

선택 인디케이터의 위치를 현재 선택된 탭으로 업데이트합니다.

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

{
    // 인디케이터 유효성 검사
    if (!TabIndicator)
        return;
 
    // 고정 폭 기반으로 X 위치 계산: X = TabSize.X * TabIndex
    FVector2D targetPosition(TabSize.X * CurTabIndex, 0.0f);
 
    // UTabIndicator에게 이동 요청
    TabIndicator->MoveTo(targetPosition, bAnimateIndicator);
}

다음을 참조함 : bAnimateIndicator, CurTabIndex, TabIndicator, TabSize.

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

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

멤버 데이터 문서화

◆ ActivateSelectColor

FLinearColor UTabButtonGroup::ActivateSelectColor = FLinearColor::White

protected

선택된 탭의 텍스트 색상.

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

◆ ActivateUnselectColor

FLinearColor UTabButtonGroup::ActivateUnselectColor = FLinearColor(0.5f, 0.5f, 0.5f)

protected

비선택된 탭의 텍스트 색상.

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

◆ bAnimateIndicator

bool UTabButtonGroup::bAnimateIndicator = true

protected

선택 인디케이터의 이동 애니메이션 활성화 여부.

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

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

◆ CurTabIndex

int32 UTabButtonGroup::CurTabIndex = -1

private

현재 선택된 탭의 인덱스.

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

다음에 의해서 참조됨 : OnSelectTab(), UpdateIndicatorPosition().

◆ DefaultTabIndex

int32 UTabButtonGroup::DefaultTabIndex = 0

protected

위젯이 생성될 때 기본으로 선택될 탭의 인덱스.

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

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

◆ IndicatorAnimationSpeed

float UTabButtonGroup::IndicatorAnimationSpeed = 0.15f

protected

선택 인디케이터의 애니메이션 속도 (초 단위).

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

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

◆ OnTabSelected

FOnTabSelected UTabButtonGroup::OnTabSelected

탭 선택이 변경될 때 발생하는 이벤트

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

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

◆ TabButtonClass

TSubclassOf<class UTabButton> UTabButtonGroup::TabButtonClass

protected

탭 버튼으로 생성할 UTabButton 위젯 블루프린트 클래스.

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

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

◆ TabButtonList

TArray<TObjectPtr<class UTabButton> > UTabButtonGroup::TabButtonList

private

동적으로 생성되어 현재 관리 중인 탭 버튼 위젯 인스턴스 배열.

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

다음에 의해서 참조됨 : ApplyTab(), OnSelectTab().

◆ TabContainer

TObjectPtr<class UHorizontalBox> UTabButtonGroup::TabContainer

protected

생성된 탭 버튼들이 추가될 컨테이너. 블루프린트에서 'TabContainer' 이름으로 생성해야 합니다.

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

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

◆ TabIndicator

TObjectPtr<class UTabIndicator> UTabButtonGroup::TabIndicator

protected

선택된 탭을 따라 움직이는 인디케이터 위젯. 블루프린트에서 'TabIndicator' 이름으로 생성해야 합니다.

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

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

◆ TabLabels

TArray<FText> UTabButtonGroup::TabLabels

protected

각 탭에 표시될 텍스트 라벨 배열. 이 배열의 크기에 따라 탭이 생성됩니다.

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

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

◆ TabSize

FVector2D UTabButtonGroup::TabSize = FVector2D(300.0f, 75.0f)

protected

각 탭의 고정 크기 (Width × Height). TabIndicator 크기도 자동으로 이 값으로 설정됩니다.

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

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

◆ TextSelectColor

FLinearColor UTabButtonGroup::TextSelectColor = FLinearColor::White

protected

선택된 탭의 텍스트 색상.

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

◆ TextUnselectColor

FLinearColor UTabButtonGroup::TextUnselectColor = FLinearColor(0.5f, 0.5f, 0.5f)

protected

비선택된 탭의 텍스트 색상.

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

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

Source/Onepiece/WidgetComponents/Public/UTabButtonGroup.h
Source/Onepiece/WidgetComponents/Private/UTabButtonGroup.cpp

Public 멤버 함수

Public 속성

Protected 멤버 함수

Protected 속성

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ ApplyTab()

◆ DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam()

◆ GetActivateColor()

◆ GetTextColor()

◆ NativeConstruct()

◆ NativePreConstruct()

◆ OnMoveCompleted()

◆ OnSelectTab()

◆ OnTabClicked()

◆ UpdateIndicatorPosition()

멤버 데이터 문서화

◆ ActivateSelectColor

◆ ActivateUnselectColor

◆ bAnimateIndicator

◆ CurTabIndex

◆ DefaultTabIndex

◆ IndicatorAnimationSpeed

◆ OnTabSelected

◆ TabButtonClass

◆ TabButtonList

◆ TabContainer

◆ TabIndicator

◆ TabLabels

◆ TabSize

◆ TextSelectColor

◆ TextUnselectColor