URichText 클래스 참조

#include <URichText.h>

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

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

Public 멤버 함수
void	SetOnClickHyperLink (const FOnClickHyperLink &InClick)
void	SetText (const FString &InString)
void	SetText (const FText &InText)
void	SetText (const FWordData &WordData)

Public 속성
bool	bAutoFitToWidth = true
FString	DefaultText
int32	FontSize = 32
int32	MinAutoFontSize = 12
TObjectPtr< class URichTextBlock >	RichTxt
FLinearColor	TextColor = FLinearColor::White

Protected 멤버 함수
virtual void	NativeConstruct () override
virtual void	NativePreConstruct () override
virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override

Private 멤버 함수
void	ApplyStyleWithFontSize (int32 InFontSize, bool bPreserveText)
void	OnClickLink (const FString &LinkID, const FString &Content)
void	UpdateFontSizeToFitWidth (const FGeometry &MyGeometry)

Private 속성
bool	bNeedsFontSizeUpdate = false
	폰트 크기 조정이 필요한지 여부
TArray< FPhonemeData >	CachedPhonemeData
int32	CurrentFontSize = 0
float	LastWidgetWidth = 0.0f
	이전 위젯 너비 (변경 감지용)
FOnClickHyperLink	OnClickHyperLink
int32	StabilizationFrames = 0
	안정화를 위한 프레임 카운터

상세한 설명

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

멤버 함수 문서화

ApplyStyleWithFontSize()

void URichText::ApplyStyleWithFontSize ( int32  InFontSize, bool  bPreserveText  )

private

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

{
    if (!RichTxt)
        return;
 
    const FText PreviousText = RichTxt->GetText();
 
    // 기존 폰트 정보 가져오기 (없으면 기본)
    FSlateFontInfo NewFont = RichTxt->GetDefaultTextStyle().Font;
    NewFont.Size = InFontSize;
 
    // 새로운 스타일 생성
    FTextBlockStyle NewStyle;
    NewStyle.SetFont(NewFont);
    NewStyle.SetColorAndOpacity(FSlateColor(TextColor));
 
    RichTxt->SetDefaultTextStyle(NewStyle);
 
    if (!bPreserveText && !DefaultText.IsEmpty() && PreviousText.IsEmpty())
    {
        RichTxt->SetText(FText::FromString(DefaultText));
    }
    else if (bPreserveText)
    {
        RichTxt->SetText(PreviousText);
    }
 
    // HyperLink Decorator 스타일도 함께 업데이트
    if (UHyperLinkPluginBPLibrary* LinkDecorator = Cast<UHyperLinkPluginBPLibrary>(
            RichTxt->GetDecoratorByClass(UHyperLinkPluginBPLibrary::StaticClass())))
    {
        FTextBlockStyle LinkTextStyle = LinkDecorator->Style.TextStyle;
        LinkTextStyle.SetFont(NewFont);
        LinkTextStyle.SetColorAndOpacity(FSlateColor(TextColor));
        LinkDecorator->Style.SetTextStyle(LinkTextStyle);
    }
 
    CurrentFontSize = InFontSize;
}

다음을 참조함 : CurrentFontSize, DefaultText, RichTxt, TextColor.

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

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

NativeConstruct()

void URichText::NativeConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativeConstruct();
 
    if (RichTxt)
    {
        if (UHyperLinkPluginBPLibrary* LinkDecorator = Cast<UHyperLinkPluginBPLibrary>(
            RichTxt->GetDecoratorByClass(UHyperLinkPluginBPLibrary::StaticClass())))
        {
            LinkDecorator->SetNativeClickHandler(FOnClickLink::CreateUObject(this, &URichText::OnClickLink));
        }
    }
}

다음을 참조함 : OnClickLink(), RichTxt.

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

NativePreConstruct()

void URichText::NativePreConstruct ( )

overrideprotectedvirtual

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

{
    Super::NativePreConstruct();
 
    if (RichTxt)
    {
        if (auto StyleSet = LoadObject<UDataTable>(nullptr, TEXT_STYLE_PATH ))
            RichTxt->SetTextStyleSet(StyleSet);
    }
 
    ApplyStyleWithFontSize(FontSize, false);
}

다음을 참조함 : ApplyStyleWithFontSize(), FontSize, RichTxt, TEXT_STYLE_PATH.

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

NativeTick()

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

overrideprotectedvirtual

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

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    // 텍스트가 변경되었거나 위젯 크기가 변경된 경우에만 폰트 크기 조정
    const float CurrentWidth = MyGeometry.GetLocalSize().X;
    if (FMath::Abs(CurrentWidth - LastWidgetWidth) > 1.0f)
    {
        LastWidgetWidth = CurrentWidth;
        bNeedsFontSizeUpdate = true;
        StabilizationFrames = 0;
    }
 
    // 폰트 크기 업데이트가 필요하고 아직 안정화되지 않은 경우에만 실행
    if (bNeedsFontSizeUpdate && StabilizationFrames < 3)
    {
        UpdateFontSizeToFitWidth(MyGeometry);
        StabilizationFrames++;
        
        // 3프레임 동안 안정화 시도 후 중단
        if (StabilizationFrames >= 3)
        {
            bNeedsFontSizeUpdate = false;
        }
    }
}

다음을 참조함 : bNeedsFontSizeUpdate, LastWidgetWidth, StabilizationFrames, UpdateFontSizeToFitWidth().

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

OnClickLink()

void URichText::OnClickLink ( const FString &  LinkID, const FString &  Content  )

private

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

{
    const int32 Index = FCString::Atoi(*LinkID);
 
    if (CachedPhonemeData.IsValidIndex(Index))
    {
        if (OnClickHyperLink.IsBound())
            OnClickHyperLink.Execute(CachedPhonemeData[Index]);
    }
}

다음을 참조함 : CachedPhonemeData, OnClickHyperLink.

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

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

SetOnClickHyperLink()

void URichText::SetOnClickHyperLink ( const FOnClickHyperLink &  InClick )

inline

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

{ OnClickHyperLink = InClick; }

SetText() [1/3]

void URichText::SetText

(

const FString &

InString

)

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

{
    if (!IsValid(RichTxt))
        return;
    
    RichTxt->SetText(FText::FromString(InString));
    
    // 텍스트가 변경되었으므로 폰트 크기 재조정 필요
    bNeedsFontSizeUpdate = true;
    StabilizationFrames = 0;
}

다음을 참조함 : bNeedsFontSizeUpdate, RichTxt, StabilizationFrames.

SetText() [2/3]

void URichText::SetText

(

const FText &

InText

)

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

{
    if (!IsValid(RichTxt))
        return;
        
    RichTxt->SetText(InText);
    
    // 텍스트가 변경되었으므로 폰트 크기 재조정 필요
    bNeedsFontSizeUpdate = true;
    StabilizationFrames = 0;
}

다음을 참조함 : bNeedsFontSizeUpdate, RichTxt, StabilizationFrames.

SetText() [3/3]

void URichText::SetText

(

const FWordData &

WordData

)

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

{
    if (!IsValid(RichTxt))
        return;
        
    CachedPhonemeData = WordData.GetPhonemeData();
 
    FString TextString;
    for (int32 i = 0; i < CachedPhonemeData.Num(); ++i)
    {
        const FPhonemeData& Phoneme = CachedPhonemeData[i];
        TextString += Phoneme.ToRichTextString(i);
    }
    RichTxt->SetText(FText::FromString(TextString));
    
    // 텍스트가 변경되었으므로 폰트 크기 재조정 필요
    bNeedsFontSizeUpdate = true;
    StabilizationFrames = 0;
}

다음을 참조함 : bNeedsFontSizeUpdate, CachedPhonemeData, FWordData::GetPhonemeData(), RichTxt, StabilizationFrames, FPhonemeData::ToRichTextString().

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

UpdateFontSizeToFitWidth()

void URichText::UpdateFontSizeToFitWidth ( const FGeometry &  MyGeometry )

private

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

{
    if (!bAutoFitToWidth || !RichTxt)
        return;
 
    const float AvailableWidth = MyGeometry.GetLocalSize().X;
    if (AvailableWidth <= 0.0f)
        return;
 
    const FVector2D DesiredSize = RichTxt->GetDesiredSize();
    const float DesiredWidth = DesiredSize.X;
 
    int32 TargetFontSize = FontSize;
 
    // Threshold 적용: 여유 공간을 2픽셀 정도 남겨서 미세한 변동 방지
    const float WidthThreshold = 2.0f;
    if (DesiredWidth > AvailableWidth + WidthThreshold && DesiredWidth > 0.0f)
    {
        // 약간 여유를 둔 스케일 계산 (98%만 사용)
        const float Scale = (AvailableWidth * 0.98f) / DesiredWidth;
        const int32 ScaledSize = FMath::FloorToInt(static_cast<float>(FontSize) * Scale);
        TargetFontSize = FMath::Clamp(ScaledSize, MinAutoFontSize, FontSize);
    }
 
    // 폰트 크기 차이가 1 이상일 때만 적용 (미세한 차이 무시)
    if (FMath::Abs(TargetFontSize - CurrentFontSize) >= 1)
    {
        ApplyStyleWithFontSize(TargetFontSize, true);
    }
}

다음을 참조함 : ApplyStyleWithFontSize(), bAutoFitToWidth, CurrentFontSize, FontSize, MinAutoFontSize, RichTxt.

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

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

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

멤버 데이터 문서화

bAutoFitToWidth

bool URichText::bAutoFitToWidth = true

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

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

bNeedsFontSizeUpdate

bool URichText::bNeedsFontSizeUpdate = false

private

폰트 크기 조정이 필요한지 여부

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

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

CachedPhonemeData

TArray<FPhonemeData> URichText::CachedPhonemeData

private

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

다음에 의해서 참조됨 : OnClickLink(), SetText().

CurrentFontSize

int32 URichText::CurrentFontSize = 0

private

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

다음에 의해서 참조됨 : ApplyStyleWithFontSize(), UpdateFontSizeToFitWidth().

DefaultText

FString URichText::DefaultText

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

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

FontSize

int32 URichText::FontSize = 32

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

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

LastWidgetWidth

float URichText::LastWidgetWidth = 0.0f

private

이전 위젯 너비 (변경 감지용)

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

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

MinAutoFontSize

int32 URichText::MinAutoFontSize = 12

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

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

OnClickHyperLink

FOnClickHyperLink URichText::OnClickHyperLink

private

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

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

RichTxt

TObjectPtr<class URichTextBlock> URichText::RichTxt

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

다음에 의해서 참조됨 : ApplyStyleWithFontSize(), NativeConstruct(), NativePreConstruct(), SetText(), SetText(), SetText(), UpdateFontSizeToFitWidth().

StabilizationFrames

int32 URichText::StabilizationFrames = 0

private

안정화를 위한 프레임 카운터

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

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

TextColor

FLinearColor URichText::TextColor = FLinearColor::White

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

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

---

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

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