UTextureButton 클래스 참조

심플한 텍스쳐 기반 버튼 위젯 더 자세히 ...

#include <UTextureButton.h>

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

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

Public 멤버 함수
void	SetButtonEnabled (bool bInEnabled)
	버튼 활성화 상태 설정
void	SetButtonSize (float InWidth, float InHeight)
	버튼 크기 설정
void	SetButtonTexture (UTexture2D *InTexture)
	버튼 배경 텍스쳐 설정
void	SetSymbolTexture (UTexture2D *InTexture)
	심볼 이미지 텍스쳐 설정

Public 속성
float	ButtonHeight = 100.0f
	버튼 높이
UTexture2D *	ButtonTexture = nullptr
	버튼 배경 텍스쳐
float	ButtonWidth = 100.0f
	버튼 너비
FLinearColor	DisabledSymbolColor = FLinearColor(0.5f, 0.5f, 0.5f, 1.0f)
	Disabled 상태 심볼 색상
FLinearColor	HoverSymbolColor = FLinearColor(1.2f, 1.2f, 1.2f, 1.0f)
	Hover 상태 심볼 색상
FLinearColor	NormalSymbolColor = FLinearColor::White
	Normal 상태 심볼 색상
FOnTextureButtonClickedEvent	OnButtonClickedEvent
	버튼 클릭 이벤트
FLinearColor	PressSymbolColor = FLinearColor(0.8f, 0.8f, 0.8f, 1.0f)
	Press 상태 심볼 색상
UTexture2D *	SymbolTexture = nullptr
	심볼 이미지 텍스쳐

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativePreConstruct () override

Private 멤버 함수
void	ApplySymbolColor (const FLinearColor &Color)
void	ApplyTextures ()
void	HandleClicked ()
void	HandleHovered ()
void	HandlePressed ()
void	HandleReleased ()
void	HandleUnhovered ()

Private 속성
bool	bEnabled = true
class UButton *	Button_Main
class UImage *	Image_Symbol

상세한 설명

심플한 텍스쳐 기반 버튼 위젯

Button이 배경 텍스쳐를 가지고, 그 안에 Image가 심볼로 표시됩니다.

• Button: 배경 이미지 (ButtonTexture) + 크기 조정
• Image_Symbol: 버튼 내부의 아이콘/심볼 (SymbolTexture)

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

멤버 함수 문서화

ApplySymbolColor()

void UTextureButton::ApplySymbolColor ( const FLinearColor &  Color )

private

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

{
    if (Image_Symbol)
    {
        Image_Symbol->SetColorAndOpacity(Color);
    }
}

다음을 참조함 : Color, Image_Symbol.

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

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

ApplyTextures()

void UTextureButton::ApplyTextures ( )

private

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

{
    // 버튼 배경 텍스쳐 설정
    if (Button_Main && ButtonTexture)
    {
        FSlateBrush Brush;
        Brush.SetResourceObject(ButtonTexture);
        
        FButtonStyle Style = Button_Main->GetStyle();
        Style.Normal = Brush;
        Style.Hovered = Brush;
        Style.Pressed = Brush;
        Button_Main->SetStyle(Style);
    }
 
    // 심볼 이미지 텍스쳐 설정
    if (Image_Symbol && SymbolTexture)
    {
        Image_Symbol->SetBrushFromTexture(SymbolTexture);
        ApplySymbolColor(NormalSymbolColor);
    }
 
    // 버튼 크기 설정
    SetButtonSize(ButtonWidth, ButtonHeight);
}

다음을 참조함 : ApplySymbolColor(), Button_Main, ButtonHeight, ButtonTexture, ButtonWidth, Image_Symbol, NormalSymbolColor, SetButtonSize(), SymbolTexture.

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

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

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

HandleClicked()

void UTextureButton::HandleClicked ( )

private

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

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

다음을 참조함 : bEnabled, OnButtonClickedEvent.

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

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

HandleHovered()

void UTextureButton::HandleHovered ( )

private

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

{
    if (!bEnabled)
        return;
 
    ApplySymbolColor(HoverSymbolColor);
}

다음을 참조함 : ApplySymbolColor(), bEnabled, HoverSymbolColor.

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

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

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

HandlePressed()

void UTextureButton::HandlePressed ( )

private

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

{
    if (!bEnabled)
        return;
 
    ApplySymbolColor(PressSymbolColor);
}

다음을 참조함 : ApplySymbolColor(), bEnabled, PressSymbolColor.

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

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

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

HandleReleased()

void UTextureButton::HandleReleased ( )

private

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

{
    if (!bEnabled)
        return;
 
    // Released 후 마우스가 여전히 버튼 위에 있는지 확인
    if (Button_Main->IsHovered())
    {
        ApplySymbolColor(HoverSymbolColor);
    }
    else
    {
        ApplySymbolColor(NormalSymbolColor);
    }
}

다음을 참조함 : ApplySymbolColor(), bEnabled, Button_Main, HoverSymbolColor, NormalSymbolColor.

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

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

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

HandleUnhovered()

void UTextureButton::HandleUnhovered ( )

private

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

{
    if (!bEnabled)
        return;
 
    ApplySymbolColor(NormalSymbolColor);
}

다음을 참조함 : ApplySymbolColor(), bEnabled, NormalSymbolColor.

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

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

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

NativeConstruct()

void UTextureButton::NativeConstruct ( )

overrideprotectedvirtual

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

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

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

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

NativePreConstruct()

void UTextureButton::NativePreConstruct ( )

overrideprotectedvirtual

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

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

다음을 참조함 : ApplyTextures().

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

SetButtonEnabled()

void UTextureButton::SetButtonEnabled

(

bool

bInEnabled

)

버튼 활성화 상태 설정

매개변수

bInEnabled

활성화 여부

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

{
    bEnabled = bInEnabled;
 
    if (Button_Main)
    {
        Button_Main->SetIsEnabled(bInEnabled);
    }
 
    // Disabled 상태 색상 적용
    if (!bEnabled)
    {
        ApplySymbolColor(DisabledSymbolColor);
    }
    else
    {
        ApplySymbolColor(NormalSymbolColor);
    }
}

다음을 참조함 : ApplySymbolColor(), bEnabled, Button_Main, DisabledSymbolColor, NormalSymbolColor.

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

SetButtonSize()

void UTextureButton::SetButtonSize	(	float	InWidth,
		float	InHeight
	)

버튼 크기 설정

매개변수

InWidth	버튼 너비
InHeight	버튼 높이

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

{
    ButtonWidth = InWidth;
    ButtonHeight = InHeight;
 
    if (Button_Main)
    {
        // Button을 SizeBox로 감싸서 크기 조정
        // 또는 RenderTransform 사용
        // UMG 구조에 따라 SizeBox가 있다면 해당 SizeBox의 크기를 설정
        // 여기서는 SetRenderTransformPivot와 SetRenderScale을 사용하지 않고
        // 위젯 블루프린트에서 SizeBox를 사용하는 것을 권장
    }
}

다음을 참조함 : Button_Main, ButtonHeight, ButtonWidth.

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

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

SetButtonTexture()

void UTextureButton::SetButtonTexture

(

UTexture2D *

InTexture

)

버튼 배경 텍스쳐 설정

매개변수

InTexture

설정할 배경 텍스쳐

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

{
    ButtonTexture = InTexture;
 
    if (Button_Main && ButtonTexture)
    {
        FSlateBrush Brush;
        Brush.SetResourceObject(ButtonTexture);
        
        FButtonStyle Style = Button_Main->GetStyle();
        Style.Normal = Brush;
        Style.Hovered = Brush;
        Style.Pressed = Brush;
        Button_Main->SetStyle(Style);
    }
}

다음을 참조함 : Button_Main, ButtonTexture.

SetSymbolTexture()

void UTextureButton::SetSymbolTexture

(

UTexture2D *

InTexture

)

심볼 이미지 텍스쳐 설정

매개변수

InTexture

설정할 심볼 텍스쳐

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

{
    SymbolTexture = InTexture;
 
    if (Image_Symbol && SymbolTexture)
    {
        Image_Symbol->SetBrushFromTexture(SymbolTexture);
    }
}

다음을 참조함 : Image_Symbol, SymbolTexture.

멤버 데이터 문서화

bEnabled

bool UTextureButton::bEnabled = true

private

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

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

Button_Main

class UButton* UTextureButton::Button_Main

private

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

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

ButtonHeight

float UTextureButton::ButtonHeight = 100.0f

버튼 높이

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

다음에 의해서 참조됨 : ApplyTextures(), SetButtonSize().

ButtonTexture

UTexture2D* UTextureButton::ButtonTexture = nullptr

버튼 배경 텍스쳐

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

다음에 의해서 참조됨 : ApplyTextures(), SetButtonTexture().

ButtonWidth

float UTextureButton::ButtonWidth = 100.0f

버튼 너비

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

다음에 의해서 참조됨 : ApplyTextures(), SetButtonSize().

DisabledSymbolColor

FLinearColor UTextureButton::DisabledSymbolColor = FLinearColor(0.5f, 0.5f, 0.5f, 1.0f)

Disabled 상태 심볼 색상

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

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

HoverSymbolColor

FLinearColor UTextureButton::HoverSymbolColor = FLinearColor(1.2f, 1.2f, 1.2f, 1.0f)

Hover 상태 심볼 색상

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

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

Image_Symbol

class UImage* UTextureButton::Image_Symbol

private

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

다음에 의해서 참조됨 : ApplySymbolColor(), ApplyTextures(), SetSymbolTexture().

NormalSymbolColor

FLinearColor UTextureButton::NormalSymbolColor = FLinearColor::White

Normal 상태 심볼 색상

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

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

OnButtonClickedEvent

FOnTextureButtonClickedEvent UTextureButton::OnButtonClickedEvent

버튼 클릭 이벤트

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

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

PressSymbolColor

FLinearColor UTextureButton::PressSymbolColor = FLinearColor(0.8f, 0.8f, 0.8f, 1.0f)

Press 상태 심볼 색상

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

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

SymbolTexture

UTexture2D* UTextureButton::SymbolTexture = nullptr

심볼 이미지 텍스쳐

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

다음에 의해서 참조됨 : ApplyTextures(), SetSymbolTexture().

---

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

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