UTabIndicator 클래스 참조

탭 선택 인디케이터 위젯. 더 자세히 ...

#include <UTabIndicator.h>

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

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

Public 멤버 함수
	DECLARE_DYNAMIC_MULTICAST_DELEGATE (FOnMoveCompleted)
	이동 완료 이벤트 델리게이트
void	MoveTo (FVector2D InTargetPosition, bool InAnimate=true)
	목표 위치로 이동합니다.
void	SetAnimationSpeed (float Speed)
	애니메이션 속도를 설정합니다.

Public 속성
FOnMoveCompleted	OnMoveCompleted
	이동 애니메이션이 완료되었을 때 발생하는 이벤트

Protected 멤버 함수
virtual void	NativeDestruct () override

Private 멤버 함수
class UCanvasPanelSlot *	GetCanvasSlot () const
	현재 위젯의 CanvasPanelSlot을 가져옵니다.
void	TickAnimation ()
	애니메이션을 위한 Tick 함수

Private 속성
float	AnimationSpeed = 0.15f
	애니메이션 속도 (초 단위)
float	AnimElapsedTime = 0.0f
	애니메이션 진행 시간
FVector2D	AnimStartPosition = FVector2D::ZeroVector
	애니메이션 시작 위치
FVector2D	AnimTargetPosition = FVector2D::ZeroVector
	애니메이션 목표 위치
FTimerHandle	AnimTimerHandle
	애니메이션을 위한 타이머 핸들
bool	bIsAnimating = false
	애니메이션 진행 중 여부

상세한 설명

탭 선택 인디케이터 위젯.

선택된 탭으로 부드럽게 이동하는 애니메이션을 제공합니다.

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

멤버 함수 문서화

DECLARE_DYNAMIC_MULTICAST_DELEGATE()

UTabIndicator::DECLARE_DYNAMIC_MULTICAST_DELEGATE

(

FOnMoveCompleted

)

이동 완료 이벤트 델리게이트

GetCanvasSlot()

UCanvasPanelSlot * UTabIndicator::GetCanvasSlot ( ) const

private

현재 위젯의 CanvasPanelSlot을 가져옵니다.

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

{
    return Cast<UCanvasPanelSlot>(Slot);
}

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

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

MoveTo()

void UTabIndicator::MoveTo	(	FVector2D	InTargetPosition,
		bool	InAnimate = true
	)

목표 위치로 이동합니다.

매개변수

[in]	InTargetPosition	이동할 목표 위치 (부모 기준 상대 좌표)
[in]	InAnimate	애니메이션 여부 (false면 즉시 이동)

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

{
    UCanvasPanelSlot* CanvasSlot = GetCanvasSlot();
    if (!CanvasSlot)
        return;
 
    // 애니메이션 없이 즉시 이동
    if (!InAnimate || AnimationSpeed <= 0.0f)
    {
        CanvasSlot->SetPosition(InTargetPosition);
        bIsAnimating = false;
 
        // 이동 완료 이벤트 발생
        OnMoveCompleted.Broadcast();
        return;
    }
 
    // 애니메이션으로 이동
    AnimStartPosition = CanvasSlot->GetPosition();
    AnimTargetPosition = InTargetPosition;
    AnimElapsedTime = 0.0f;
    bIsAnimating = true;
 
    // 타이머 시작 (기존 타이머가 있다면 제거)
    if (GetWorld())
    {
        GetWorld()->GetTimerManager().ClearTimer(AnimTimerHandle);
        GetWorld()->GetTimerManager().SetTimer(
            AnimTimerHandle,
            this,
            &UTabIndicator::TickAnimation,
            0.016f, // ~60 FPS
            true
        );
    }
}

다음을 참조함 : AnimationSpeed, AnimElapsedTime, AnimStartPosition, AnimTargetPosition, AnimTimerHandle, bIsAnimating, GetCanvasSlot(), OnMoveCompleted, TickAnimation().

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

NativeDestruct()

void UTabIndicator::NativeDestruct ( )

overrideprotectedvirtual

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

{
    Super::NativeDestruct();
 
    // 타이머 정리
    if (GetWorld())
    {
        GetWorld()->GetTimerManager().ClearTimer(AnimTimerHandle);
    }
}

다음을 참조함 : AnimTimerHandle.

SetAnimationSpeed()

void UTabIndicator::SetAnimationSpeed

(

float

Speed

)

애니메이션 속도를 설정합니다.

매개변수

[in]

Speed

애니메이션 속도 (초 단위)

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

{
    AnimationSpeed = FMath::Max(0.01f, Speed);
}

다음을 참조함 : AnimationSpeed.

TickAnimation()

void UTabIndicator::TickAnimation ( )

private

애니메이션을 위한 Tick 함수

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

{
    // Canvas Slot 유효성 검사
    UCanvasPanelSlot* CanvasSlot = GetCanvasSlot();
    if (!CanvasSlot)
    {
        if (GetWorld())
            GetWorld()->GetTimerManager().ClearTimer(AnimTimerHandle);
        
        bIsAnimating = false;
        return;
    }
 
    // 애니메이션 진행
    AnimElapsedTime += 0.016f; // ~60 FPS 기준
    const float Alpha = FMath::Clamp(AnimElapsedTime / AnimationSpeed, 0.0f, 1.0f);
 
    // Lerp를 사용한 부드러운 이동
    FVector2D CurPosition = FMath::Lerp(AnimStartPosition, AnimTargetPosition, Alpha);
    CanvasSlot->SetPosition(CurPosition);
 
    // 애니메이션 완료 확인
    if (Alpha >= 1.0f)
    {
        // 타이머 정지
        if (GetWorld())
        {
            GetWorld()->GetTimerManager().ClearTimer(AnimTimerHandle);
        }
 
        bIsAnimating = false;
 
        // 이동 완료 이벤트 발생
        OnMoveCompleted.Broadcast();
    }
}

다음을 참조함 : AnimationSpeed, AnimElapsedTime, AnimStartPosition, AnimTargetPosition, AnimTimerHandle, bIsAnimating, GetCanvasSlot(), OnMoveCompleted.

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

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

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

멤버 데이터 문서화

AnimationSpeed

float UTabIndicator::AnimationSpeed = 0.15f

private

애니메이션 속도 (초 단위)

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

다음에 의해서 참조됨 : MoveTo(), SetAnimationSpeed(), TickAnimation().

AnimElapsedTime

float UTabIndicator::AnimElapsedTime = 0.0f

private

애니메이션 진행 시간

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

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

AnimStartPosition

FVector2D UTabIndicator::AnimStartPosition = FVector2D::ZeroVector

private

애니메이션 시작 위치

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

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

AnimTargetPosition

FVector2D UTabIndicator::AnimTargetPosition = FVector2D::ZeroVector

private

애니메이션 목표 위치

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

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

AnimTimerHandle

FTimerHandle UTabIndicator::AnimTimerHandle

private

애니메이션을 위한 타이머 핸들

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

다음에 의해서 참조됨 : MoveTo(), NativeDestruct(), TickAnimation().

bIsAnimating

bool UTabIndicator::bIsAnimating = false

private

애니메이션 진행 중 여부

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

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

OnMoveCompleted

FOnMoveCompleted UTabIndicator::OnMoveCompleted

이동 애니메이션이 완료되었을 때 발생하는 이벤트

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

다음에 의해서 참조됨 : MoveTo(), TickAnimation().

---

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

• Source/Onepiece/WidgetComponents/Public/UTabIndicator.h
• Source/Onepiece/WidgetComponents/Private/UTabIndicator.cpp