UPageScrollView.h

이 파일의 문서화 페이지로 가기

// Copyright (c) 2025 Doppleddiggong. All rights reserved. Unauthorized copying, modification, or distribution of this file, via any medium is strictly prohibited. Proprietary and confidential.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Blueprint/UserWidget.h"
#include "EPageScrollDirection.h"
#include "UPageScrollView.generated.h"
 
DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnPageChanged, int32, PrevPage, int32, CurrentPage);
 
UCLASS()
class ONEPIECE_API UPageScrollView : public UUserWidget
{
    GENERATED_BODY()
 
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;
 
public:
    UFUNCTION(BlueprintCallable, Category = "PageScrollView")
    void MovePage(int32 PageIndex, bool bAnimate = true);
 
    UFUNCTION(BlueprintCallable, Category = "PageScrollView")
    void SetNumberOfPages(int32 ItemCount);
 
    UFUNCTION(BlueprintCallable, Category = "PageScrollView")
    void NextPage();
 
    UFUNCTION(BlueprintCallable, Category = "PageScrollView")
    void PrevPage();
 
    UFUNCTION(BlueprintCallable, BlueprintPure, Category = "PageScrollView")
    int32 GetCurrentPage() const { return CurPageIndex; }
 
    UFUNCTION(BlueprintCallable, BlueprintPure, Category = "PageScrollView")
    int32 GetTotalPages() const { return pageItemList.Num(); }
 
    UFUNCTION(BlueprintCallable, BlueprintPure, Category = "PageScrollView")
    UPageScrollItem* GetPageAt(int32 Index) const
    {
        return pageItemList.IsValidIndex(Index) ? pageItemList[Index] : nullptr;
    }
    
private:
    int32 CalculateTargetPage(FVector2D DragDelta, float Velocity) const;
 
    void TickSnapAnimation();
 
    void StopAnimation();
 
    FVector2D GetPagePosition(int32 PageIndex) const;
 
    FORCEINLINE float GetPageStride() const
    {
        return (ScrollDirection == EPageScrollDirection::Horizontal)
            ? (PageSize.X + PageSpacing)
            : (PageSize.Y + PageSpacing);
    }
 
    void SetContainerPosition(FVector2D Position);
 
    void UpdatePageDotIndicator();
 
    void UpdateItemScales();
 
    void UpdateContainerPositionDuringDrag();
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Layout")
    EPageScrollDirection ScrollDirection = EPageScrollDirection::Horizontal;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Layout")
    FVector2D PageSize = FVector2D(1920.0f, 1080.0f);
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Layout")
    float PageSpacing = 0.0f;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Behavior")
    float FastSwipeThreshold = 500.0f;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Behavior")
    float SnapAnimationSpeed = 0.3f;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Behavior")
    bool bEnableScaleEffect = false;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Behavior", meta=(EditCondition="bEnableScaleEffect"))
    float FocusScale = 1.0f;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Behavior", meta=(EditCondition="bEnableScaleEffect"))
    float SideScale = 0.8f;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Data")
    TSubclassOf<class UPageScrollItem> PageItemClass;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "PageScrollView|Data")
    int32 DefaultPageIndex = 0;
 
    UPROPERTY(BlueprintReadOnly, meta = (BindWidget))
    TObjectPtr<class UCanvasPanel> PageContainer;
 
    UPROPERTY(BlueprintReadOnly, meta = (BindWidgetOptional))
    TObjectPtr<class UPageScrollDot> PageDotIndicator;
 
    UPROPERTY(BlueprintAssignable, Category = "PageScrollView|Events")
    FOnPageChanged OnPageChanged;
 
private:
    int32 CurPageIndex = 0;
 
    int32 PrevPageIndex = 0;
 
    UPROPERTY()
    TArray<TObjectPtr<class UPageScrollItem>> pageItemList;
 
    bool bIsDragging = false;
    FVector2D dragStartPosition = FVector2D::ZeroVector;
    FVector2D dragCurrentPosition = FVector2D::ZeroVector;
    float dragStartTime = 0.0f;
 
    FTimerHandle snapAnimTimerHandle;
    FVector2D animStartPosition = FVector2D::ZeroVector;
    FVector2D animTargetPosition = FVector2D::ZeroVector;
    float animElapsedTime = 0.0f;
    bool bIsAnimating = false;
 
    FVector2D ViewportSize = FVector2D::ZeroVector;
};