페이지 단위 스크롤 뷰 위젯 드래그 기반 스크롤과 자동 스냅 기능을 제공하는 메인 컨트롤러 위젯입니다. 더 자세히 ...

#include <UPageScrollView.h>

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

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

Public 멤버 함수
int32	GetCurrentPage () const
	현재 페이지 인덱스를 반환합니다.

UPageScrollItem *	GetPageAt (int32 Index) const
	특정 인덱스의 페이지 아이템을 반환합니다.

int32	GetTotalPages () const
	총 페이지 수를 반환합니다.

void	MovePage (int32 PageIndex, bool bAnimate=true)
	특정 페이지로 이동합니다.

void	NextPage ()
	다음 페이지로 이동합니다.

void	PrevPage ()
	이전 페이지로 이동합니다.

void	SetNumberOfPages (int32 ItemCount)
	페이지 개수를 설정하고 동적으로 생성합니다.

Public 속성
bool	bEnableScaleEffect = false
	중앙 스케일 효과 활성화 여부

int32	DefaultPageIndex = 0
	기본으로 선택될 페이지 인덱스

float	FastSwipeThreshold = 500.0f
	빠른 스와이프 인식 임계값 (픽셀/초)

float	FocusScale = 1.0f
	중앙에 있는 페이지의 스케일 값

FOnPageChanged	OnPageChanged
	페이지 변경 이벤트

TObjectPtr< class UCanvasPanel >	PageContainer
	페이지 아이템들을 담을 컨테이너 (드래그로 위치 이동)

TObjectPtr< class UPageScrollDot >	PageDotIndicator
	페이지 인디케이터 (선택적)

TSubclassOf< class UPageScrollItem >	PageItemClass
	페이지 아이템으로 생성할 위젯 블루프린트 클래스

FVector2D	PageSize = FVector2D(1920.0f, 1080.0f)
	각 페이지의 크기 (Width × Height)

float	PageSpacing = 0.0f
	페이지 간 간격 (픽셀)

EPageScrollDirection	ScrollDirection = EPageScrollDirection::Horizontal
	스크롤 방향 (수평/수직)

float	SideScale = 0.8f
	중앙에서 벗어난 페이지의 스케일 값

float	SnapAnimationSpeed = 0.3f
	스냅 애니메이션 속도 (초 단위)

Protected 멤버 함수
virtual void	NativeConstruct () override

virtual void	NativeDestruct () override

virtual FReply	NativeOnMouseButtonDown (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
	마우스 버튼 다운 이벤트

virtual FReply	NativeOnMouseButtonUp (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
	마우스 버튼 업 이벤트

virtual FReply	NativeOnMouseMove (const FGeometry &InGeometry, const FPointerEvent &InMouseEvent) override
	마우스 이동 이벤트

Private 멤버 함수
int32	CalculateTargetPage (FVector2D DragDelta, float Velocity) const
	드래그 종료 시 목표 페이지를 계산합니다.

FVector2D	GetPagePosition (int32 PageIndex) const
	페이지 인덱스에 해당하는 목표 위치를 계산합니다.

FORCEINLINE float	GetPageStride () const
	페이지 간 거리를 계산합니다.

void	SetContainerPosition (FVector2D Position)
	컨테이너 위치를 설정합니다.

void	StopAnimation ()
	스냅 애니메이션을 중지합니다.

void	TickSnapAnimation ()
	스냅 애니메이션을 Tick합니다.

void	UpdateContainerPositionDuringDrag ()
	드래그 중 컨테이너 위치를 업데이트합니다.

void	UpdateItemScales ()
	페이지 아이템들의 스케일을 거리 기반으로 업데이트합니다.

void	UpdatePageDotIndicator ()
	페이지 인디케이터를 업데이트합니다.

Private 속성
float	animElapsedTime = 0.0f

FVector2D	animStartPosition = FVector2D::ZeroVector

FVector2D	animTargetPosition = FVector2D::ZeroVector

bool	bIsAnimating = false

bool	bIsDragging = false
	드래그 상태 추적

int32	CurPageIndex = 0
	현재 선택된 페이지 인덱스

FVector2D	dragCurrentPosition = FVector2D::ZeroVector

FVector2D	dragStartPosition = FVector2D::ZeroVector

float	dragStartTime = 0.0f

TArray< TObjectPtr< class UPageScrollItem > >	pageItemList
	생성된 페이지 아이템 목록

int32	PrevPageIndex = 0
	이전 페이지 인덱스 (스냅 계산용)

FTimerHandle	snapAnimTimerHandle
	애니메이션 상태

FVector2D	ViewportSize = FVector2D::ZeroVector
	뷰포트 크기 (SizeBox에서 계산)

상세한 설명

페이지 단위 스크롤 뷰 위젯 드래그 기반 스크롤과 자동 스냅 기능을 제공하는 메인 컨트롤러 위젯입니다.

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

멤버 함수 문서화

◆ CalculateTargetPage()

int32 UPageScrollView::CalculateTargetPage	(	FVector2D	DragDelta,
		float	Velocity
	)		const

private

드래그 종료 시 목표 페이지를 계산합니다.

매개변수

[in]	DragDelta	드래그 이동 거리
[in]	Velocity	드래그 속도 (픽셀/초)

반환값: 목표 페이지 인덱스

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

{
    float delta = (ScrollDirection == EPageScrollDirection::Horizontal)
        ? DragDelta.X
        : DragDelta.Y;
 
    int32 targetPage = CurPageIndex;
 
    // 빠른 스와이프 감지
    if (Velocity >= FastSwipeThreshold)
    {
        // 양수: 오른쪽/아래로 드래그 → 이전 페이지
        // 음수: 왼쪽/위로 드래그 → 다음 페이지
        targetPage = (delta > 0) ? CurPageIndex - 1 : CurPageIndex + 1;
    }
    else
    {
        // 느린 드래그: 가장 가까운 페이지로 스냅
        float dragRatio = delta / GetPageStride();
        int32 dragPages = FMath::RoundToInt(dragRatio);
        targetPage = CurPageIndex - dragPages; // 음수 방향 (Unity와 동일)
    }
 
    // 범위 제한
    return FMath::Clamp(targetPage, 0, pageItemList.Num() - 1);
}

다음을 참조함 : CurPageIndex, FastSwipeThreshold, GetPageStride(), pageItemList, ScrollDirection.

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

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

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

◆ GetCurrentPage()

int32 UPageScrollView::GetCurrentPage ( ) const

inline

현재 페이지 인덱스를 반환합니다.

반환값: 현재 페이지 인덱스

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

58{ return CurPageIndex; }

◆ GetPageAt()

UPageScrollItem * UPageScrollView::GetPageAt ( int32 Index ) const

inline

특정 인덱스의 페이지 아이템을 반환합니다.

매개변수

[in] Index 페이지 인덱스

반환값: 페이지 아이템 (없으면 nullptr)

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

    {
        return pageItemList.IsValidIndex(Index) ? pageItemList[Index] : nullptr;
    }

◆ GetPagePosition()

FVector2D UPageScrollView::GetPagePosition ( int32 PageIndex ) const

private

페이지 인덱스에 해당하는 목표 위치를 계산합니다.

매개변수

[in] PageIndex 페이지 인덱스

반환값: 목표 위치 (2D Vector)

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

{
    float stride = GetPageStride();
    float offset = -stride * PageIndex; // 음수: 컨테이너를 왼쪽/위로 이동
 
    return ScrollDirection == EPageScrollDirection::Horizontal ?  FVector2D(offset, 0.0f) : FVector2D(0.0f, offset);
}

다음을 참조함 : GetPageStride(), ScrollDirection.

다음에 의해서 참조됨 : MovePage(), UpdateContainerPositionDuringDrag().

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

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

◆ GetPageStride()

FORCEINLINE float UPageScrollView::GetPageStride ( ) const

inlineprivate

페이지 간 거리를 계산합니다.

반환값: 페이지 크기 + 간격

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

    {
        return (ScrollDirection == EPageScrollDirection::Horizontal)
            ? (PageSize.X + PageSpacing)
            : (PageSize.Y + PageSpacing);
    }

다음에 의해서 참조됨 : CalculateTargetPage(), GetPagePosition(), SetNumberOfPages(), UpdateItemScales().

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

◆ GetTotalPages()

int32 UPageScrollView::GetTotalPages ( ) const

inline

총 페이지 수를 반환합니다.

반환값: 총 페이지 수

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

63{ return pageItemList.Num(); }

◆ MovePage()

void UPageScrollView::MovePage	(	int32	PageIndex,
		bool	bAnimate = `true`
	)

특정 페이지로 이동합니다.

매개변수

[in]	PageIndex	이동할 페이지 인덱스
[in]	bAnimate	애니메이션 여부

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

{
    if (!pageItemList.IsValidIndex(PageIndex))
        return;
 
    int32 prevPage = CurPageIndex;
    CurPageIndex = PageIndex;
 
    FVector2D targetPosition = GetPagePosition(PageIndex);
 
    // Phase 1: 애니메이션 없이 즉시 이동
    if (!bAnimate || SnapAnimationSpeed <= 0.0f)
    {
        SetContainerPosition(targetPosition);
 
        // 페이지 변경 이벤트 발생
        if (prevPage != CurPageIndex)
        {
            OnPageChanged.Broadcast(prevPage, CurPageIndex);
        }
 
        // 인디케이터 업데이트
        UpdatePageDotIndicator();
 
        // 스케일 효과 업데이트
        if (bEnableScaleEffect)
        {
            UpdateItemScales();
        }
        return;
    }
 
    // Phase 2에서 구현: 애니메이션 이동
    UCanvasPanelSlot* containerSlot = Cast<UCanvasPanelSlot>(PageContainer->Slot);
    if (!containerSlot)
    {
        SetContainerPosition(targetPosition);
        return;
    }
 
    animStartPosition = containerSlot->GetPosition();
    animTargetPosition = targetPosition;
    animElapsedTime = 0.0f;
    bIsAnimating = true;
 
    // 타이머 시작
    if (GetWorld())
    {
        GetWorld()->GetTimerManager().ClearTimer(snapAnimTimerHandle);
        GetWorld()->GetTimerManager().SetTimer(
            snapAnimTimerHandle,
            this,
            &UPageScrollView::TickSnapAnimation,
            0.016f, // ~60 FPS
            true
        );
    }
}

다음을 참조함 : animElapsedTime, animStartPosition, animTargetPosition, bEnableScaleEffect, bIsAnimating, CurPageIndex, GetPagePosition(), OnPageChanged, PageContainer, pageItemList, SetContainerPosition(), SnapAnimationSpeed, snapAnimTimerHandle, TickSnapAnimation(), UpdateItemScales(), UpdatePageDotIndicator().

다음에 의해서 참조됨 : NativeConstruct(), NativeOnMouseButtonUp(), NextPage(), PrevPage(), SetNumberOfPages().

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

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

◆ NativeConstruct()

void UPageScrollView::NativeConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativeConstruct();
 
    // 뷰포트 크기 계산 (SizeBox의 크기)
    if (UCanvasPanelSlot* RootSlot = Cast<UCanvasPanelSlot>(Slot))
    {
        ViewportSize = RootSlot->GetSize();
    }
 
    // ViewportSize 계산 실패 시 PageSize 사용
    if (ViewportSize.X <= 1.0f || ViewportSize.Y <= 1.0f)
    {
        ViewportSize = PageSize;
    }
 
    // 기본 페이지로 이동 (애니메이션 없이)
    if (pageItemList.Num() > 0 && pageItemList.IsValidIndex(DefaultPageIndex))
    {
        MovePage(DefaultPageIndex, false);
    }
}

다음을 참조함 : DefaultPageIndex, MovePage(), pageItemList, PageSize, ViewportSize.

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

◆ NativeDestruct()

void UPageScrollView::NativeDestruct ( )

overrideprotectedvirtual

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

{
    Super::NativeDestruct();
 
    // 타이머 정리
    StopAnimation();
}

다음을 참조함 : StopAnimation().

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

◆ NativeOnMouseButtonDown()

FReply UPageScrollView::NativeOnMouseButtonDown	(	const FGeometry &	InGeometry,
		const FPointerEvent &	InMouseEvent
	)

overrideprotectedvirtual

마우스 버튼 다운 이벤트

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

{
    if (!InMouseEvent.IsMouseButtonDown(EKeys::LeftMouseButton))
        return FReply::Unhandled();
 
    // 애니메이션 중지
    StopAnimation();
 
    // 드래그 시작
    bIsDragging = true;
    dragStartPosition = InMouseEvent.GetScreenSpacePosition();
    dragCurrentPosition = dragStartPosition;
    dragStartTime = GetWorld() ? GetWorld()->GetTimeSeconds() : 0.0f;
    PrevPageIndex = CurPageIndex;
 
    // TakeWidget()으로 SWidget을 가져와서 Mouse Capture
    TSharedPtr<SWidget> CachedWidget = GetCachedWidget();
    if (CachedWidget.IsValid())
    {
        return FReply::Handled().CaptureMouse(CachedWidget.ToSharedRef());
    }
 
    return FReply::Handled();
}

다음을 참조함 : bIsDragging, CurPageIndex, dragCurrentPosition, dragStartPosition, dragStartTime, PrevPageIndex, StopAnimation().

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

◆ NativeOnMouseButtonUp()

FReply UPageScrollView::NativeOnMouseButtonUp	(	const FGeometry &	InGeometry,
		const FPointerEvent &	InMouseEvent
	)

overrideprotectedvirtual

마우스 버튼 업 이벤트

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

{
    if (!bIsDragging)
        return FReply::Unhandled();
 
    bIsDragging = false;
 
    // 드래그 거리 계산
    FVector2D dragDelta = dragCurrentPosition - dragStartPosition;
    float dragDistance = dragDelta.Size();
 
    // 작은 드래그는 클릭으로 처리 (버튼 이벤트 전달)
    if (dragDistance <= 10.0f)
    {
        return FReply::Handled().ReleaseMouseCapture();
    }
 
    // 드래그 속도 계산 (픽셀/초)
    float dragTime = GetWorld() ? (GetWorld()->GetTimeSeconds() - dragStartTime) : 0.01f;
    float velocity = dragDistance / FMath::Max(dragTime, 0.01f);
 
    // 목표 페이지 계산
    int32 targetPage = CalculateTargetPage(dragDelta, velocity);
 
    // 목표 페이지로 이동
    MovePage(targetPage, true);
 
    return FReply::Handled().ReleaseMouseCapture();
}

다음을 참조함 : bIsDragging, CalculateTargetPage(), dragCurrentPosition, dragStartPosition, dragStartTime, MovePage().

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

◆ NativeOnMouseMove()

FReply UPageScrollView::NativeOnMouseMove	(	const FGeometry &	InGeometry,
		const FPointerEvent &	InMouseEvent
	)

overrideprotectedvirtual

마우스 이동 이벤트

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

{
    if (!bIsDragging)
        return FReply::Unhandled();
 
    dragCurrentPosition = InMouseEvent.GetScreenSpacePosition();
 
    // 드래그 중 실시간 컨테이너 위치 업데이트
    UpdateContainerPositionDuringDrag();
 
    return FReply::Handled();
}

다음을 참조함 : bIsDragging, dragCurrentPosition, UpdateContainerPositionDuringDrag().

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

◆ NextPage()

void UPageScrollView::NextPage ( )

다음 페이지로 이동합니다.

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

{
    int32 targetPage = FMath::Clamp(CurPageIndex + 1, 0, pageItemList.Num() - 1);
    MovePage(targetPage, true);
}

다음을 참조함 : CurPageIndex, MovePage(), pageItemList.

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

◆ PrevPage()

void UPageScrollView::PrevPage ( )

이전 페이지로 이동합니다.

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

{
    int32 targetPage = FMath::Clamp(CurPageIndex - 1, 0, pageItemList.Num() - 1);
    MovePage(targetPage, true);
}

다음을 참조함 : CurPageIndex, MovePage(), pageItemList.

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

◆ SetContainerPosition()

void UPageScrollView::SetContainerPosition ( FVector2D Position )

private

컨테이너 위치를 설정합니다.

매개변수

[in] Position 설정할 위치

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

{
    if (UCanvasPanelSlot* containerSlot = Cast<UCanvasPanelSlot>(PageContainer->Slot))
    {
        containerSlot->SetPosition(Position);
    }
}

다음을 참조함 : PageContainer.

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

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

◆ SetNumberOfPages()

void UPageScrollView::SetNumberOfPages ( int32 ItemCount )

페이지 개수를 설정하고 동적으로 생성합니다.

매개변수

[in] ItemCount 생성할 페이지 수

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

{
    if (!PageContainer || !PageItemClass)
        return;
 
    // 기존 페이지 제거
    pageItemList.Empty();
    PageContainer->ClearChildren();
 
    // 새 페이지 생성
    for (int32 i = 0; i < ItemCount; ++i)
    {
        UPageScrollItem* newItem = CreateWidget<UPageScrollItem>(GetWorld(), PageItemClass);
        if (!newItem)
            continue;
 
        // 페이지 초기화
        newItem->InitData(i, this);
 
        // PageContainer에 추가
        UCanvasPanelSlot* slot = PageContainer->AddChildToCanvas(newItem);
        if (slot)
        {
            // 페이지 아이템 위치 설정 (0부터 오른쪽으로 배치)
            float stride = GetPageStride();
            FVector2D itemPosition;
            if (ScrollDirection == EPageScrollDirection::Horizontal)
                itemPosition = FVector2D(stride * i, 0.0f);
            else
                itemPosition = FVector2D(0.0f, stride * i);
 
            slot->SetAnchors(FAnchors(0.0f, 0.0f, 0.0f, 0.0f)); // 왼쪽 위 고정
            slot->SetAlignment(FVector2D(0.0f, 0.0f));
            slot->SetPosition(itemPosition);
            slot->SetSize(PageSize);
        }
 
        pageItemList.Add(newItem);
    }
 
    // 인디케이터 업데이트
    if (PageDotIndicator)
    {
        PageDotIndicator->SetNumberOfPages(ItemCount);
 
        // 페이지가 1개 이하면 인디케이터 숨김
        PageDotIndicator->SetVisibility(ItemCount > 1 ? ESlateVisibility::Visible : ESlateVisibility::Collapsed);
    }
 
    // 기본 페이지로 이동
    if (pageItemList.Num() > 0 && pageItemList.IsValidIndex(DefaultPageIndex))
    {
        MovePage(DefaultPageIndex, false);
    }
}

다음을 참조함 : DefaultPageIndex, GetPageStride(), UPageScrollItem::InitData(), MovePage(), PageContainer, PageDotIndicator, PageItemClass, pageItemList, PageSize, ScrollDirection.

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

◆ StopAnimation()

void UPageScrollView::StopAnimation ( )

private

스냅 애니메이션을 중지합니다.

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

{
    if (GetWorld())
    {
        GetWorld()->GetTimerManager().ClearTimer(snapAnimTimerHandle);
    }
 
    bIsAnimating = false;
}

다음을 참조함 : bIsAnimating, snapAnimTimerHandle.

다음에 의해서 참조됨 : NativeDestruct(), NativeOnMouseButtonDown(), TickSnapAnimation().

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

◆ TickSnapAnimation()

void UPageScrollView::TickSnapAnimation ( )

private

스냅 애니메이션을 Tick합니다.

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

{
    // Canvas Slot 유효성 검사
    UCanvasPanelSlot* containerSlot = Cast<UCanvasPanelSlot>(PageContainer->Slot);
    if (!containerSlot)
    {
        StopAnimation();
        return;
    }
 
    // 애니메이션 진행
    animElapsedTime += 0.016f; // ~60 FPS 기준
    const float Alpha = FMath::Clamp(animElapsedTime / SnapAnimationSpeed, 0.0f, 1.0f);
 
    // Ease-out curve 적용
    float easedAlpha = FMath::InterpEaseOut(0.0f, 1.0f, Alpha, 2.0f);
 
    // Lerp를 사용한 부드러운 이동
    FVector2D currentPosition = FMath::Lerp(animStartPosition, animTargetPosition, easedAlpha);
    containerSlot->SetPosition(currentPosition);
 
    // 스케일 효과 업데이트
    if (bEnableScaleEffect)
    {
        UpdateItemScales();
    }
 
    // 애니메이션 완료 확인
    if (Alpha >= 1.0f)
    {
        StopAnimation();
 
        // 페이지 변경 이벤트 발생
        if (PrevPageIndex != CurPageIndex)
        {
            OnPageChanged.Broadcast(PrevPageIndex, CurPageIndex);
        }
 
        // 인디케이터 업데이트
        UpdatePageDotIndicator();
    }
}

다음을 참조함 : animElapsedTime, animStartPosition, animTargetPosition, bEnableScaleEffect, CurPageIndex, OnPageChanged, PageContainer, PrevPageIndex, SnapAnimationSpeed, StopAnimation(), UpdateItemScales(), UpdatePageDotIndicator().

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

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

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

◆ UpdateContainerPositionDuringDrag()

void UPageScrollView::UpdateContainerPositionDuringDrag ( )

private

드래그 중 컨테이너 위치를 업데이트합니다.

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

{
    if (!bIsDragging)
        return;
 
    UCanvasPanelSlot* containerSlot = Cast<UCanvasPanelSlot>(PageContainer->Slot);
    if (!containerSlot)
        return;
 
    // 드래그 델타 계산
    FVector2D dragDelta = dragCurrentPosition - dragStartPosition;
 
    // 이전 위치에서 드래그 델타만큼 이동
    FVector2D basePosition = GetPagePosition(PrevPageIndex);
    FVector2D newPosition = basePosition;
 
    if (ScrollDirection == EPageScrollDirection::Horizontal)
        newPosition.X += dragDelta.X;
    else
        newPosition.Y += dragDelta.Y;
 
    containerSlot->SetPosition(newPosition);
 
    // 스케일 효과 업데이트
    if (bEnableScaleEffect)
    {
        UpdateItemScales();
    }
}

다음을 참조함 : bEnableScaleEffect, bIsDragging, dragCurrentPosition, dragStartPosition, GetPagePosition(), PageContainer, PrevPageIndex, ScrollDirection, UpdateItemScales().

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

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

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

◆ UpdateItemScales()

void UPageScrollView::UpdateItemScales ( )

private

페이지 아이템들의 스케일을 거리 기반으로 업데이트합니다.

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

{
    if (!bEnableScaleEffect)
        return;
 
    UCanvasPanelSlot* containerSlot = Cast<UCanvasPanelSlot>(PageContainer->Slot);
    if (!containerSlot)
        return;
 
    FVector2D containerPos = containerSlot->GetPosition();
    // ViewportSize 대신 PageSize 사용 (ViewportSize 계산이 실패할 수 있음)
    float viewportCenter = (ScrollDirection == EPageScrollDirection::Horizontal)
        ? PageSize.X * 0.5f
        : PageSize.Y * 0.5f;
 
    for (int32 i = 0; i < pageItemList.Num(); ++i)
    {
        UPageScrollItem* item = pageItemList[i];
        if (!item)
            continue;
 
        // 페이지 아이템의 실제 위치 (0부터 오른쪽으로 배치됨)
        float stride = GetPageStride();
        FVector2D pagePos;
        if (ScrollDirection == EPageScrollDirection::Horizontal)
            pagePos = FVector2D(stride * i, 0.0f);
        else
            pagePos = FVector2D(0.0f, stride * i);
 
        float pageCenter = (ScrollDirection == EPageScrollDirection::Horizontal)
            ? (containerPos.X + pagePos.X + PageSize.X * 0.5f)
            : (containerPos.Y + pagePos.Y + PageSize.Y * 0.5f);
 
        float distance = FMath::Abs(pageCenter - viewportCenter);
        float maxDistance = GetPageStride();
        float normalizedDistance = FMath::Clamp(distance / maxDistance, 0.0f, 1.0f);
 
        // Lerp from focus scale to side scale
        float scale = FMath::Lerp(FocusScale, SideScale, normalizedDistance);
 
        item->SetRenderScale(FVector2D(scale, scale));
        item->UpdateFocusState(normalizedDistance < 0.1f, scale);
    }
}

다음을 참조함 : bEnableScaleEffect, FocusScale, GetPageStride(), PageContainer, pageItemList, PageSize, ScrollDirection, SideScale, UPageScrollItem::UpdateFocusState().

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation(), UpdateContainerPositionDuringDrag().

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

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

◆ UpdatePageDotIndicator()

void UPageScrollView::UpdatePageDotIndicator ( )

private

페이지 인디케이터를 업데이트합니다.

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

{
    if (PageDotIndicator)
    {
        PageDotIndicator->SetCurrentPage(CurPageIndex);
    }
}

다음을 참조함 : CurPageIndex, PageDotIndicator.

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

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

멤버 데이터 문서화

◆ animElapsedTime

float UPageScrollView::animElapsedTime = 0.0f

private

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

◆ animStartPosition

FVector2D UPageScrollView::animStartPosition = FVector2D::ZeroVector

private

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

◆ animTargetPosition

FVector2D UPageScrollView::animTargetPosition = FVector2D::ZeroVector

private

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

◆ bEnableScaleEffect

bool UPageScrollView::bEnableScaleEffect = false

중앙 스케일 효과 활성화 여부

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation(), UpdateContainerPositionDuringDrag(), UpdateItemScales().

◆ bIsAnimating

bool UPageScrollView::bIsAnimating = false

private

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

다음에 의해서 참조됨 : MovePage(), StopAnimation().

◆ bIsDragging

bool UPageScrollView::bIsDragging = false

private

드래그 상태 추적

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

다음에 의해서 참조됨 : NativeOnMouseButtonDown(), NativeOnMouseButtonUp(), NativeOnMouseMove(), UpdateContainerPositionDuringDrag().

◆ CurPageIndex

int32 UPageScrollView::CurPageIndex = 0

private

현재 선택된 페이지 인덱스

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

다음에 의해서 참조됨 : CalculateTargetPage(), MovePage(), NativeOnMouseButtonDown(), NextPage(), PrevPage(), TickSnapAnimation(), UpdatePageDotIndicator().

◆ DefaultPageIndex

int32 UPageScrollView::DefaultPageIndex = 0

기본으로 선택될 페이지 인덱스

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

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

◆ dragCurrentPosition

FVector2D UPageScrollView::dragCurrentPosition = FVector2D::ZeroVector

private

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

다음에 의해서 참조됨 : NativeOnMouseButtonDown(), NativeOnMouseButtonUp(), NativeOnMouseMove(), UpdateContainerPositionDuringDrag().

◆ dragStartPosition

FVector2D UPageScrollView::dragStartPosition = FVector2D::ZeroVector

private

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

다음에 의해서 참조됨 : NativeOnMouseButtonDown(), NativeOnMouseButtonUp(), UpdateContainerPositionDuringDrag().

◆ dragStartTime

float UPageScrollView::dragStartTime = 0.0f

private

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

다음에 의해서 참조됨 : NativeOnMouseButtonDown(), NativeOnMouseButtonUp().

◆ FastSwipeThreshold

float UPageScrollView::FastSwipeThreshold = 500.0f

빠른 스와이프 인식 임계값 (픽셀/초)

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

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

◆ FocusScale

float UPageScrollView::FocusScale = 1.0f

중앙에 있는 페이지의 스케일 값

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

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

◆ OnPageChanged

FOnPageChanged UPageScrollView::OnPageChanged

페이지 변경 이벤트

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

◆ PageContainer

TObjectPtr<class UCanvasPanel> UPageScrollView::PageContainer

페이지 아이템들을 담을 컨테이너 (드래그로 위치 이동)

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

다음에 의해서 참조됨 : MovePage(), SetContainerPosition(), SetNumberOfPages(), TickSnapAnimation(), UpdateContainerPositionDuringDrag(), UpdateItemScales().

◆ PageDotIndicator

TObjectPtr<class UPageScrollDot> UPageScrollView::PageDotIndicator

페이지 인디케이터 (선택적)

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

다음에 의해서 참조됨 : SetNumberOfPages(), UpdatePageDotIndicator().

◆ PageItemClass

TSubclassOf<class UPageScrollItem> UPageScrollView::PageItemClass

페이지 아이템으로 생성할 위젯 블루프린트 클래스

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

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

◆ pageItemList

TArray<TObjectPtr<class UPageScrollItem> > UPageScrollView::pageItemList

private

생성된 페이지 아이템 목록

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

다음에 의해서 참조됨 : CalculateTargetPage(), MovePage(), NativeConstruct(), NextPage(), PrevPage(), SetNumberOfPages(), UpdateItemScales().

◆ PageSize

FVector2D UPageScrollView::PageSize = FVector2D(1920.0f, 1080.0f)

각 페이지의 크기 (Width × Height)

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

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

◆ PageSpacing

float UPageScrollView::PageSpacing = 0.0f

페이지 간 간격 (픽셀)

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

◆ PrevPageIndex

int32 UPageScrollView::PrevPageIndex = 0

private

이전 페이지 인덱스 (스냅 계산용)

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

다음에 의해서 참조됨 : NativeOnMouseButtonDown(), TickSnapAnimation(), UpdateContainerPositionDuringDrag().

◆ ScrollDirection

EPageScrollDirection UPageScrollView::ScrollDirection = EPageScrollDirection::Horizontal

스크롤 방향 (수평/수직)

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

다음에 의해서 참조됨 : CalculateTargetPage(), GetPagePosition(), SetNumberOfPages(), UpdateContainerPositionDuringDrag(), UpdateItemScales().

◆ SideScale

float UPageScrollView::SideScale = 0.8f

중앙에서 벗어난 페이지의 스케일 값

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

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

◆ SnapAnimationSpeed

float UPageScrollView::SnapAnimationSpeed = 0.3f

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

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

다음에 의해서 참조됨 : MovePage(), TickSnapAnimation().

◆ snapAnimTimerHandle

FTimerHandle UPageScrollView::snapAnimTimerHandle

private

애니메이션 상태

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

다음에 의해서 참조됨 : MovePage(), StopAnimation().

◆ ViewportSize

FVector2D UPageScrollView::ViewportSize = FVector2D::ZeroVector

private

뷰포트 크기 (SizeBox에서 계산)

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

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

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

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

Public 멤버 함수

Public 속성

Protected 멤버 함수

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ CalculateTargetPage()

◆ GetCurrentPage()

◆ GetPageAt()

◆ GetPagePosition()

◆ GetPageStride()

◆ GetTotalPages()

◆ MovePage()

◆ NativeConstruct()

◆ NativeDestruct()

◆ NativeOnMouseButtonDown()

◆ NativeOnMouseButtonUp()

◆ NativeOnMouseMove()

◆ NextPage()

◆ PrevPage()

◆ SetContainerPosition()

◆ SetNumberOfPages()

◆ StopAnimation()

◆ TickSnapAnimation()

◆ UpdateContainerPositionDuringDrag()

◆ UpdateItemScales()

◆ UpdatePageDotIndicator()

멤버 데이터 문서화

◆ animElapsedTime

◆ animStartPosition

◆ animTargetPosition

◆ bEnableScaleEffect

◆ bIsAnimating

◆ bIsDragging

◆ CurPageIndex

◆ DefaultPageIndex

◆ dragCurrentPosition

◆ dragStartPosition

◆ dragStartTime

◆ FastSwipeThreshold

◆ FocusScale

◆ OnPageChanged

◆ PageContainer

◆ PageDotIndicator

◆ PageItemClass

◆ pageItemList

◆ PageSize

◆ PageSpacing

◆ PrevPageIndex

◆ ScrollDirection

◆ SideScale

◆ SnapAnimationSpeed

◆ snapAnimTimerHandle

◆ ViewportSize