#include <UImageButton.h>

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

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

Public 멤버 함수
void	SetButtonEnabled (bool bInEnabled)
	버튼의 활성화/비활성화 상태를 설정합니다.

Public 속성
TEnumAsByte< ESlateBrushDrawType::Type >	BorderDrawAs = ESlateBrushDrawType::Image
	Border 이미지의 그리기 방식 (Image, Box, Border, RoundedBox 등)

UTexture2D *	BorderImage = nullptr
	Border에 적용할 이미지 (null이면 색상만 사용)

FMargin	BorderMargin = FMargin(0.0f)
	Border 이미지의 여백 (9-slice 방식으로 그릴 때 사용)

bool	bUseFixedSize = false
	고정 크기 사용 여부

float	FixedHeight = 100.0f
	고정 높이 (bUseFixedSize가 true일 때 적용)

float	FixedWidth = 200.0f
	고정 너비 (bUseFixedSize가 true일 때 적용)

int32	FontOutlineSize = 0

int32	FontSize = 48

FLinearColor	HoverButtonColor = FLinearColor(0.2f, 0.2f, 0.2f)

FLinearColor	HoverTextColor = FLinearColor(0.8f, 0.9f, 1.f)

FText	LabelText = FText::FromString("Button")

FLinearColor	NormalButtonColor = FLinearColor(0.1f, 0.1f, 0.1f)

FLinearColor	NormalTextColor = FLinearColor::White

FOnImageButtonClickedEvent	OnButtonClickedEvent
	버튼 클릭 시 발생하는 이벤트

FLinearColor	PressButtonColor = FLinearColor(0.05f, 0.05f, 0.05f)

FLinearColor	PressTextColor = FLinearColor(0.6f, 0.7f, 1.f)

Protected 멤버 함수
virtual void	NativeConstruct () override

virtual void	NativePreConstruct () override

virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override

Private 멤버 함수
void	ApplyStyle ()
	설정된 스타일 속성을 위젯에 적용합니다.

void	HandleClicked ()

void	HandleHovered ()

void	HandlePressed ()

void	HandleReleased ()

void	HandleUnhovered ()

Private 속성
bool	bBorderBrushInitialized = false

bool	bEnabled = true

class UBorder *	Border_BG

class UButton *	Button_Main

FSlateBrush	CachedBorderBrush

float	CurrentBrightness = 1.0f

FVector2D	CurrentScale = FVector2D(1.f, 1.f)

float	LerpSpeed = 20.f

class USizeBox *	SizeBox_Root

float	TargetBrightness = 1.f

FVector2D	TargetScale = FVector2D(1.f, 1.f)

class UTextBlock *	Text_Label

상세한 설명

UImageButton

UHoverButton과 동일한 호버/프레스 애니메이션 기능을 제공하며, 추가로 Border 이미지 설정 및 고정 크기 설정이 가능한 버튼 위젯입니다.

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

멤버 함수 문서화

◆ ApplyStyle()

void UImageButton::ApplyStyle ( )

private

설정된 스타일 속성을 위젯에 적용합니다.

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

{
    // ========== 텍스트 스타일 적용 ==========
    if (Text_Label)
    {
        Text_Label->SetText(LabelText);
 
        FSlateFontInfo NewFont = Text_Label->GetFont();
        NewFont.OutlineSettings.OutlineSize = FontOutlineSize;
        NewFont.Size = FontSize;
        Text_Label->SetFont(NewFont);
 
        Text_Label->SetColorAndOpacity(NormalTextColor);
    }
 
    // ========== Border 배경 및 이미지 적용 ==========
    if (Border_BG)
    {
        // Border 이미지가 설정되어 있으면 이미지 사용
        if (BorderImage)
        {
            CachedBorderBrush.SetResourceObject(BorderImage);
            CachedBorderBrush.DrawAs = BorderDrawAs;
            CachedBorderBrush.Margin = BorderMargin;
            CachedBorderBrush.TintColor = FSlateColor(NormalButtonColor);
            Border_BG->SetBrush(CachedBorderBrush);
            bBorderBrushInitialized = true;
        }
        else
        {
            // 이미지가 없으면 색상만 사용
            Border_BG->SetBrushColor(NormalButtonColor);
            bBorderBrushInitialized = false;
        }
    }
 
    // ========== 고정 크기 적용 ==========
    if (SizeBox_Root)
    {
        if (bUseFixedSize)
        {
            SizeBox_Root->SetWidthOverride(FixedWidth);
            SizeBox_Root->SetHeightOverride(FixedHeight);
        }
        else
        {
            // 고정 크기를 사용하지 않으면 자동 크기 조정
            SizeBox_Root->ClearWidthOverride();
            SizeBox_Root->ClearHeightOverride();
        }
    }
}

다음을 참조함 : bBorderBrushInitialized, Border_BG, BorderDrawAs, BorderImage, BorderMargin, bUseFixedSize, CachedBorderBrush, FixedHeight, FixedWidth, FontOutlineSize, FontSize, LabelText, NormalButtonColor, NormalTextColor, SizeBox_Root, Text_Label.

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

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

◆ HandleClicked()

void UImageButton::HandleClicked ( )

private

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

{
    if (!bEnabled)
        return;
 
    OnButtonClickedEvent.Broadcast();
}

다음을 참조함 : bEnabled, OnButtonClickedEvent.

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

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

◆ HandleHovered()

void UImageButton::HandleHovered ( )

private

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

{
    if (!bEnabled)
        return;
 
    TargetScale = FVector2D(1.06f, 1.06f);
    TargetBrightness = 1.15f;
 
    if (Text_Label)
    {
        Text_Label->SetColorAndOpacity(HoverTextColor);
    }
 
    if (Border_BG)
    {
        if (BorderImage && bBorderBrushInitialized)
        {
            // 이미지가 있으면 Tint 색상 변경
            CachedBorderBrush.TintColor = FSlateColor(HoverButtonColor);
            Border_BG->SetBrush(CachedBorderBrush);
        }
        else
        {
            Border_BG->SetBrushColor(HoverButtonColor);
        }
    }
}

다음을 참조함 : bBorderBrushInitialized, bEnabled, Border_BG, BorderImage, CachedBorderBrush, HoverButtonColor, HoverTextColor, TargetBrightness, TargetScale, Text_Label.

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

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

◆ HandlePressed()

void UImageButton::HandlePressed ( )

private

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

{
    if (!bEnabled)
        return;
 
    TargetScale = FVector2D(0.97f, 0.97f);
 
    if (Text_Label)
    {
        Text_Label->SetColorAndOpacity(PressTextColor);
    }
 
    if (Border_BG)
    {
        if (BorderImage && bBorderBrushInitialized)
        {
            CachedBorderBrush.TintColor = FSlateColor(PressButtonColor);
            Border_BG->SetBrush(CachedBorderBrush);
        }
        else
        {
            Border_BG->SetBrushColor(PressButtonColor);
        }
    }
}

다음을 참조함 : bBorderBrushInitialized, bEnabled, Border_BG, BorderImage, CachedBorderBrush, PressButtonColor, PressTextColor, TargetScale, Text_Label.

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

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

◆ HandleReleased()

void UImageButton::HandleReleased ( )

private

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

{
    if (!bEnabled)
        return;
 
    if (Button_Main && Button_Main->IsHovered())
        HandleHovered();
    else
        HandleUnhovered();
}

다음을 참조함 : bEnabled, Button_Main, HandleHovered(), HandleUnhovered().

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

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

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

◆ HandleUnhovered()

void UImageButton::HandleUnhovered ( )

private

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

{
    if (!bEnabled)
        return;
 
    TargetScale = FVector2D(1.0f, 1.0f);
    TargetBrightness = 1.0f;
 
    if (Text_Label)
    {
        Text_Label->SetColorAndOpacity(NormalTextColor);
    }
 
    if (Border_BG)
    {
        if (BorderImage && bBorderBrushInitialized)
        {
            CachedBorderBrush.TintColor = FSlateColor(NormalButtonColor);
            Border_BG->SetBrush(CachedBorderBrush);
        }
        else
        {
            Border_BG->SetBrushColor(NormalButtonColor);
        }
    }
}

다음을 참조함 : bBorderBrushInitialized, bEnabled, Border_BG, BorderImage, CachedBorderBrush, NormalButtonColor, NormalTextColor, TargetBrightness, TargetScale, Text_Label.

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

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

◆ NativeConstruct()

void UImageButton::NativeConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativeConstruct();
 
    if (Button_Main)
    {
        // 중복 등록 방지를 위해 기존 바인딩 제거
        Button_Main->OnHovered.RemoveDynamic(this, &UImageButton::HandleHovered);
        Button_Main->OnUnhovered.RemoveDynamic(this, &UImageButton::HandleUnhovered);
        Button_Main->OnPressed.RemoveDynamic(this, &UImageButton::HandlePressed);
        Button_Main->OnReleased.RemoveDynamic(this, &UImageButton::HandleReleased);
        Button_Main->OnClicked.RemoveDynamic(this, &UImageButton::HandleClicked);
 
        Button_Main->OnHovered.AddDynamic(this, &UImageButton::HandleHovered);
        Button_Main->OnUnhovered.AddDynamic(this, &UImageButton::HandleUnhovered);
        Button_Main->OnPressed.AddDynamic(this, &UImageButton::HandlePressed);
        Button_Main->OnReleased.AddDynamic(this, &UImageButton::HandleReleased);
        Button_Main->OnClicked.AddDynamic(this, &UImageButton::HandleClicked);
    }
}

다음을 참조함 : Button_Main, HandleClicked(), HandleHovered(), HandlePressed(), HandleReleased(), HandleUnhovered().

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

◆ NativePreConstruct()

void UImageButton::NativePreConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativePreConstruct();
    ApplyStyle();
}

다음을 참조함 : ApplyStyle().

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

◆ NativeTick()

void UImageButton::NativeTick	(	const FGeometry &	MyGeometry,
		float	InDeltaTime
	)

overrideprotectedvirtual

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

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    // 스케일 보간
    CurrentScale = FMath::Vector2DInterpTo(CurrentScale, TargetScale, InDeltaTime, LerpSpeed);
    SetRenderScale(CurrentScale);
}

다음을 참조함 : CurrentScale, LerpSpeed, TargetScale.

◆ SetButtonEnabled()

void UImageButton::SetButtonEnabled ( bool bInEnabled )

버튼의 활성화/비활성화 상태를 설정합니다.

매개변수

bInEnabled true면 활성화, false면 비활성화

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

{
    bEnabled = bInEnabled;
 
    if (Button_Main)
    {
        Button_Main->SetIsEnabled(bInEnabled);
    }
 
    if (bInEnabled)
    {
        TargetScale = FVector2D(1.f, 1.f);
        TargetBrightness = 1.f;
 
        if (Border_BG)
        {
            if (BorderImage && bBorderBrushInitialized)
            {
                CachedBorderBrush.TintColor = FSlateColor(NormalButtonColor);
                Border_BG->SetBrush(CachedBorderBrush);
            }
            else
            {
                Border_BG->SetBrushColor(NormalButtonColor);
            }
        }
 
        if (Text_Label)
        {
            Text_Label->SetColorAndOpacity(NormalTextColor);
        }
    }
    else
    {
        TargetScale = FVector2D(1.f, 1.f);
        TargetBrightness = 0.4f;
 
        if (Border_BG)
        {
            if (BorderImage && bBorderBrushInitialized)
            {
                CachedBorderBrush.TintColor = FSlateColor(NormalButtonColor * 0.5f);
                Border_BG->SetBrush(CachedBorderBrush);
            }
            else
            {
                Border_BG->SetBrushColor(NormalButtonColor * 0.5f);
            }
        }
 
        if (Text_Label)
        {
            Text_Label->SetColorAndOpacity(NormalTextColor * 0.5f);
        }
    }
}

다음을 참조함 : bBorderBrushInitialized, bEnabled, Border_BG, BorderImage, Button_Main, CachedBorderBrush, NormalButtonColor, NormalTextColor, TargetBrightness, TargetScale, Text_Label.

멤버 데이터 문서화

◆ bBorderBrushInitialized

bool UImageButton::bBorderBrushInitialized = false

private

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

다음에 의해서 참조됨 : ApplyStyle(), HandleHovered(), HandlePressed(), HandleUnhovered(), SetButtonEnabled().

◆ bEnabled

bool UImageButton::bEnabled = true

private

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

다음에 의해서 참조됨 : HandleClicked(), HandleHovered(), HandlePressed(), HandleReleased(), HandleUnhovered(), SetButtonEnabled().

◆ Border_BG

class UBorder* UImageButton::Border_BG

private

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

다음에 의해서 참조됨 : ApplyStyle(), HandleHovered(), HandlePressed(), HandleUnhovered(), SetButtonEnabled().

◆ BorderDrawAs

TEnumAsByte<ESlateBrushDrawType::Type> UImageButton::BorderDrawAs = ESlateBrushDrawType::Image

Border 이미지의 그리기 방식 (Image, Box, Border, RoundedBox 등)

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

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

◆ BorderImage

UTexture2D* UImageButton::BorderImage = nullptr

Border에 적용할 이미지 (null이면 색상만 사용)

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

다음에 의해서 참조됨 : ApplyStyle(), HandleHovered(), HandlePressed(), HandleUnhovered(), SetButtonEnabled().

◆ BorderMargin

FMargin UImageButton::BorderMargin = FMargin(0.0f)

Border 이미지의 여백 (9-slice 방식으로 그릴 때 사용)

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

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

◆ bUseFixedSize

bool UImageButton::bUseFixedSize = false

고정 크기 사용 여부

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

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

◆ Button_Main

class UButton* UImageButton::Button_Main

private

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

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

◆ CachedBorderBrush

FSlateBrush UImageButton::CachedBorderBrush

private

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

다음에 의해서 참조됨 : ApplyStyle(), HandleHovered(), HandlePressed(), HandleUnhovered(), SetButtonEnabled().

◆ CurrentBrightness

float UImageButton::CurrentBrightness = 1.0f

private

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

◆ CurrentScale

FVector2D UImageButton::CurrentScale = FVector2D(1.f, 1.f)

private

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

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

◆ FixedHeight

float UImageButton::FixedHeight = 100.0f

고정 높이 (bUseFixedSize가 true일 때 적용)

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

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

◆ FixedWidth

float UImageButton::FixedWidth = 200.0f

고정 너비 (bUseFixedSize가 true일 때 적용)

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

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

◆ FontOutlineSize

int32 UImageButton::FontOutlineSize = 0

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

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

◆ FontSize

int32 UImageButton::FontSize = 48

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

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

◆ HoverButtonColor

FLinearColor UImageButton::HoverButtonColor = FLinearColor(0.2f, 0.2f, 0.2f)

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

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

◆ HoverTextColor

FLinearColor UImageButton::HoverTextColor = FLinearColor(0.8f, 0.9f, 1.f)

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

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

◆ LabelText

FText UImageButton::LabelText = FText::FromString("Button")

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

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

◆ LerpSpeed

float UImageButton::LerpSpeed = 20.f

private

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

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

◆ NormalButtonColor

FLinearColor UImageButton::NormalButtonColor = FLinearColor(0.1f, 0.1f, 0.1f)

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

다음에 의해서 참조됨 : ApplyStyle(), HandleUnhovered(), SetButtonEnabled().

◆ NormalTextColor

FLinearColor UImageButton::NormalTextColor = FLinearColor::White

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

다음에 의해서 참조됨 : ApplyStyle(), HandleUnhovered(), SetButtonEnabled().

◆ OnButtonClickedEvent

FOnImageButtonClickedEvent UImageButton::OnButtonClickedEvent

버튼 클릭 시 발생하는 이벤트

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

다음에 의해서 참조됨 : HandleClicked(), UPopup_MsgBox::InitButton(), UPopup_InputMsg::InitPopup(), UPopup_AskTutorial::NativeConstruct(), ULobbyWidget::NativeConstruct().

◆ PressButtonColor

FLinearColor UImageButton::PressButtonColor = FLinearColor(0.05f, 0.05f, 0.05f)

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

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

◆ PressTextColor

FLinearColor UImageButton::PressTextColor = FLinearColor(0.6f, 0.7f, 1.f)

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

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

◆ SizeBox_Root

class USizeBox* UImageButton::SizeBox_Root

private

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

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

◆ TargetBrightness

float UImageButton::TargetBrightness = 1.f

private

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

다음에 의해서 참조됨 : HandleHovered(), HandleUnhovered(), SetButtonEnabled().

◆ TargetScale

FVector2D UImageButton::TargetScale = FVector2D(1.f, 1.f)

private

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

다음에 의해서 참조됨 : HandleHovered(), HandlePressed(), HandleUnhovered(), NativeTick(), SetButtonEnabled().

◆ Text_Label

class UTextBlock* UImageButton::Text_Label

private

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

다음에 의해서 참조됨 : ApplyStyle(), HandleHovered(), HandlePressed(), HandleUnhovered(), SetButtonEnabled().

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

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

Public 멤버 함수

Public 속성

Protected 멤버 함수

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ ApplyStyle()

◆ HandleClicked()

◆ HandleHovered()

◆ HandlePressed()

◆ HandleReleased()

◆ HandleUnhovered()

◆ NativeConstruct()

◆ NativePreConstruct()

◆ NativeTick()

◆ SetButtonEnabled()

멤버 데이터 문서화

◆ bBorderBrushInitialized

◆ bEnabled

◆ Border_BG

◆ BorderDrawAs

◆ BorderImage

◆ BorderMargin

◆ bUseFixedSize

◆ Button_Main

◆ CachedBorderBrush

◆ CurrentBrightness

◆ CurrentScale

◆ FixedHeight

◆ FixedWidth

◆ FontOutlineSize

◆ FontSize

◆ HoverButtonColor

◆ HoverTextColor

◆ LabelText

◆ LerpSpeed

◆ NormalButtonColor

◆ NormalTextColor

◆ OnButtonClickedEvent

◆ PressButtonColor

◆ PressTextColor

◆ SizeBox_Root

◆ TargetBrightness

◆ TargetScale

◆ Text_Label