UChatWidget 클래스 참조

#include <ChatWidget.h>

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

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

Public 멤버 함수
	UChatWidget (const FObjectInitializer &ObjectInitializer)
void	FocusInput ()
virtual void	NativeConstruct () override
virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override
void	OnInputFocusChanged (bool bHasFocus)
void	SendMessage (FResponseUserMe sendUser, FText inMessage, int32 PlayerIndex)

Protected 속성
TObjectPtr< class UChatInputBox >	ChatInputBox
TSubclassOf< class UChatBoxWidget >	LeftChatBoxWidgetClass
TSubclassOf< class UChatBoxWidget >	RightChatBoxWidgetClass
TObjectPtr< class UScrollBox >	ScrollBox_ChatBox
TObjectPtr< class USizeBox >	SizeBox_Chat
TObjectPtr< class USpacer >	Spacer_Content
TObjectPtr< class UVerticalBox >	VerticalBox_Content

Private 멤버 함수
class UChatBoxWidget *	CreateChatBox (bool bIsSender)
void	OnFadeOutTimerComplete ()
void	StartFadeOutTimer ()

Private 속성
float	AutoHideDelay = 5.0f
bool	bIsFading = false
float	CurrentOpacity = 1.0f
FTimerHandle	FadeOutTimerHandle
float	FadeSpeed = 2.0f
float	TargetOpacity = 1.0f

상세한 설명

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

생성자 & 소멸자 문서화

UChatWidget()

UChatWidget::UChatWidget

(

const FObjectInitializer &

ObjectInitializer

)

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

                                                                    : Super(ObjectInitializer)
{
    ConstructorHelpers::FClassFinder<UChatBoxWidget> LeftChatBoxWidgetClassRef(TEXT("/Game/CustomContents/UI/Widgets/Chat/WBP_LeftChatMessage.WBP_LeftChatMessage_C"));
    if (LeftChatBoxWidgetClassRef.Succeeded())
    {
        LeftChatBoxWidgetClass = LeftChatBoxWidgetClassRef.Class;
    }
    ConstructorHelpers::FClassFinder<UChatBoxWidget> RightChatBoxWidgetClassRef(TEXT("/Game/CustomContents/UI/Widgets/Chat/WBP_RightChatMessage.WBP_RightChatMessage_C"));
    if (RightChatBoxWidgetClassRef.Succeeded())
    {
        RightChatBoxWidgetClass = RightChatBoxWidgetClassRef.Class;
    }
}

다음을 참조함 : LeftChatBoxWidgetClass, RightChatBoxWidgetClass.

멤버 함수 문서화

CreateChatBox()

UChatBoxWidget * UChatWidget::CreateChatBox ( bool  bIsSender )

private

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

{
    return CreateWidget<UChatBoxWidget>(GetWorld(), bIsSender? LeftChatBoxWidgetClass : RightChatBoxWidgetClass );
}

다음을 참조함 : LeftChatBoxWidgetClass, RightChatBoxWidgetClass.

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

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

FocusInput()

void UChatWidget::FocusInput

(

)

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

{
    ChatInputBox->SetInputFocus(true);
 
    // 입력 포커스를 얻을 때 완전히 보이게 하고 타이머 중단
    TargetOpacity = 1.0f;
    CurrentOpacity = 1.0f;
    SetRenderOpacity(1.0f);
    bIsFading = false;
 
    // 타이머 중단
    if (GetWorld() && GetWorld()->GetTimerManager().IsTimerActive(FadeOutTimerHandle))
    {
        GetWorld()->GetTimerManager().ClearTimer(FadeOutTimerHandle);
    }
}

다음을 참조함 : bIsFading, ChatInputBox, CurrentOpacity, FadeOutTimerHandle, TargetOpacity.

NativeConstruct()

void UChatWidget::NativeConstruct ( )

overridevirtual

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

{
    Super::NativeConstruct();
 
    SetIsFocusable(true);
 
    // 초기 상태는 페이드아웃 (약간 투명하게)
    SetRenderOpacity(0.2f);
    CurrentOpacity = 0.2f;
    TargetOpacity = 0.2f;
 
    // ChatInputBox에 자신을 설정
    if (ChatInputBox)
    {
        ChatInputBox->SetOwningChatWidget(this);
    }
}

다음을 참조함 : ChatInputBox, CurrentOpacity, TargetOpacity.

NativeTick()

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

overridevirtual

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

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    // 페이드 처리
    if (bIsFading && CurrentOpacity != TargetOpacity)
    {
        // 부드럽게 Opacity 변경
        float Delta = FadeSpeed * InDeltaTime;
        if (CurrentOpacity > TargetOpacity)
        {
            CurrentOpacity = FMath::Max(CurrentOpacity - Delta, TargetOpacity);
        }
        else
        {
            CurrentOpacity = FMath::Min(CurrentOpacity + Delta, TargetOpacity);
        }
 
        SetRenderOpacity(CurrentOpacity);
 
        // 목표 도달 시 페이드 종료
        if (FMath::IsNearlyEqual(CurrentOpacity, TargetOpacity, 0.01f))
        {
            bIsFading = false;
        }
    }
}

다음을 참조함 : bIsFading, CurrentOpacity, FadeSpeed, TargetOpacity.

OnFadeOutTimerComplete()

void UChatWidget::OnFadeOutTimerComplete ( )

private

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

{
    // 입력창에 포커스가 있으면 페이드아웃하지 않음
    if (ChatInputBox && ChatInputBox->HasKeyboardFocus())
        return;
 
    // 페이드아웃 시작
    TargetOpacity = 0.2f; // 완전히 투명하게 하지 않고 약간 보이게
    bIsFading = true;
}

다음을 참조함 : bIsFading, ChatInputBox, TargetOpacity.

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

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

OnInputFocusChanged()

void UChatWidget::OnInputFocusChanged

(

bool

bHasFocus

)

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

{
    if (bHasFocus)
    {
        // 포커스를 얻으면 완전히 보이게 하고 타이머 중단
        TargetOpacity = 1.0f;
        CurrentOpacity = 1.0f;
        SetRenderOpacity(1.0f);
        bIsFading = false;
 
        if (GetWorld() && GetWorld()->GetTimerManager().IsTimerActive(FadeOutTimerHandle))
        {
            GetWorld()->GetTimerManager().ClearTimer(FadeOutTimerHandle);
        }
    }
    else
    {
        // 포커스를 잃으면 5초 후 페이드아웃 시작
        StartFadeOutTimer();
    }
}

다음을 참조함 : bIsFading, CurrentOpacity, FadeOutTimerHandle, StartFadeOutTimer(), TargetOpacity.

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

SendMessage()

void UChatWidget::SendMessage	(	FResponseUserMe	sendUser,
		FText	inMessage,
		int32	PlayerIndex
	)

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

{
    auto* PC = Cast<APlayerControl>(GetWorld()->GetFirstPlayerController<APlayerController>());
    if (!PC)
    {
        PRINTLOG(TEXT("Cannot get playercontroller"));
    }
 
    // 메시지 받은 플레이어 정보 가져오기
    FResponseUserMe info = PC->GetUserInfo();
    bool bIsSender = (info.id == sendUser.id);
 
    // ChatBox 생성
    UChatBoxWidget* newChat = CreateChatBox(bIsSender);
    newChat->SetMessage(inMessage);
 
    newChat->SetPlayerProfile(
        sendUser.GetChatProfileBg(PlayerIndex),
        sendUser.GetChatProfileTextureType(PlayerIndex));
 
    newChat->SetPlayerName(FText::FromString(sendUser.username));
    newChat->SetMessage(inMessage);
    newChat->SetChatBubbleColor(bIsSender);
 
    // ChatBox에 추가 & 정렬
    VerticalBox_Content->AddChild(newChat);
 
    UScrollBoxSlot* parentSlot = Cast<UScrollBoxSlot>(newChat->Slot);
    if (parentSlot)
    {
        parentSlot->SetHorizontalAlignment((bIsSender ? HAlign_Left : HAlign_Right));
    }
 
    // 위젯의 레이아웃을 강제로 갱신하여 정확한 크기 계산
    newChat->ForceLayoutPrepass();
 
    // 부모 위젯들의 레이아웃을 무효화하여 다음 틱에 재계산
    VerticalBox_Content->InvalidateLayoutAndVolatility();
    ScrollBox_ChatBox->InvalidateLayoutAndVolatility();
 
    // 현재 스크롤 값 & 마지막 스크롤 값
    float scrollOffset = ScrollBox_ChatBox->GetScrollOffset();
    float scrollOffsetOfEnd = ScrollBox_ChatBox->GetScrollOffsetOfEnd();
    
    if (bIsSender || scrollOffset == scrollOffsetOfEnd)
    {
        // 레이아웃 갱신 후 스크롤 (타이머 사용)
        FTimerHandle ScrollTimerHandle;
        GetWorld()->GetTimerManager().SetTimer(ScrollTimerHandle, [this, newChat]()
        {
            // 마지막 위젯을 뷰에 표시
            ScrollBox_ChatBox->ScrollWidgetIntoView(newChat, true, EDescendantScrollDestination::BottomOrRight);
 
            // 추가로 ScrollToEnd도 실행
            ScrollBox_ChatBox->ScrollToEnd();
        }, 0.1f, false);
    }
 
    UWidgetBlueprintLibrary::SetFocusToGameViewport();
    PC->SetInputMode(FInputModeGameOnly());
    PC->SetShowMouseCursor(false);
 
    // 채팅창을 완전히 보이게 하고 5초 후 페이드아웃 타이머 시작
    TargetOpacity = 1.0f;
    CurrentOpacity = 1.0f;
    SetRenderOpacity(1.0f);
    bIsFading = false;
    
    StartFadeOutTimer();
}

다음을 참조함 : bIsFading, CreateChatBox(), CurrentOpacity, FResponseUserMe::GetChatProfileBg(), FResponseUserMe::GetChatProfileTextureType(), FResponseUserMe::id, PRINTLOG, ScrollBox_ChatBox, UChatBoxWidget::SetChatBubbleColor(), UChatBoxWidget::SetMessage(), UChatBoxWidget::SetPlayerName(), UChatBoxWidget::SetPlayerProfile(), StartFadeOutTimer(), TargetOpacity, FResponseUserMe::username, VerticalBox_Content.

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

StartFadeOutTimer()

void UChatWidget::StartFadeOutTimer ( )

private

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

{
    if (!GetWorld())
        return;
 
    // 기존 타이머가 있으면 취소
    if (GetWorld()->GetTimerManager().IsTimerActive(FadeOutTimerHandle))
    {
        GetWorld()->GetTimerManager().ClearTimer(FadeOutTimerHandle);
    }
 
    // 5초 후 페이드아웃 시작
    GetWorld()->GetTimerManager().SetTimer(FadeOutTimerHandle, this, &UChatWidget::OnFadeOutTimerComplete, AutoHideDelay, false);
}

다음을 참조함 : AutoHideDelay, FadeOutTimerHandle, OnFadeOutTimerComplete().

다음에 의해서 참조됨 : OnInputFocusChanged(), SendMessage().

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

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

멤버 데이터 문서화

AutoHideDelay

float UChatWidget::AutoHideDelay = 5.0f

private

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

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

bIsFading

bool UChatWidget::bIsFading = false

private

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

다음에 의해서 참조됨 : FocusInput(), NativeTick(), OnFadeOutTimerComplete(), OnInputFocusChanged(), SendMessage().

ChatInputBox

TObjectPtr<class UChatInputBox> UChatWidget::ChatInputBox

protected

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

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

CurrentOpacity

float UChatWidget::CurrentOpacity = 1.0f

private

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

다음에 의해서 참조됨 : FocusInput(), NativeConstruct(), NativeTick(), OnInputFocusChanged(), SendMessage().

FadeOutTimerHandle

FTimerHandle UChatWidget::FadeOutTimerHandle

private

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

다음에 의해서 참조됨 : FocusInput(), OnInputFocusChanged(), StartFadeOutTimer().

FadeSpeed

float UChatWidget::FadeSpeed = 2.0f

private

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

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

LeftChatBoxWidgetClass

TSubclassOf<class UChatBoxWidget> UChatWidget::LeftChatBoxWidgetClass

protected

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

다음에 의해서 참조됨 : UChatWidget(), CreateChatBox().

RightChatBoxWidgetClass

TSubclassOf<class UChatBoxWidget> UChatWidget::RightChatBoxWidgetClass

protected

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

다음에 의해서 참조됨 : UChatWidget(), CreateChatBox().

ScrollBox_ChatBox

TObjectPtr<class UScrollBox> UChatWidget::ScrollBox_ChatBox

protected

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

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

SizeBox_Chat

TObjectPtr<class USizeBox> UChatWidget::SizeBox_Chat

protected

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

Spacer_Content

TObjectPtr<class USpacer> UChatWidget::Spacer_Content

protected

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

TargetOpacity

float UChatWidget::TargetOpacity = 1.0f

private

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

다음에 의해서 참조됨 : FocusInput(), NativeConstruct(), NativeTick(), OnFadeOutTimerComplete(), OnInputFocusChanged(), SendMessage().

VerticalBox_Content

TObjectPtr<class UVerticalBox> UChatWidget::VerticalBox_Content

protected

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

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

---

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

• Source/Onepiece/UI/Public/ChatWidget.h
• Source/Onepiece/UI/Private/ChatWidget.cpp