unreal 自定义 Slate Style Sets

搜集到的最有价值的一篇教学，按照作者的方法尝试中遇到了一些问题。【感谢这位作者!】

网址：https://wiki.unrealengine.com/Slate_Style_Sets_Part_2

在此，我将详述我的制作过程。本文原创，转载请写明出处，违者必究！

首先创建 xxStyle， 我这里测试就以 Test命名。

#pragma once
#include "SlateStyle.h"

class TestStyles
{
public:
    static void Initialize();

    static void Shutdown();
    
    static const class ISlateStyle& Get();

    static FName    GetStyleSetName();

private:

    static TSharedRef<class FSlateStyleSet>    Create();

    static TSharedPtr<class FSlateStyleSet>    Instance;
};

这个类是自己创建的，没有经过 UnrealEditor 的创建向导。（当然你也可以使用向导）

#include "Test05.h"
#include "TestStyles.h"
#include "SlateGameResources.h"


TSharedPtr<FSlateStyleSet> TestStyles::Instance = nullptr;


void TestStyles::Initialize()
{
    if (!Instance.IsValid())
    {
        Instance = Create();

        FSlateStyleRegistry::RegisterSlateStyle(*Instance);
    }
}

void TestStyles::Shutdown()
{
    FSlateStyleRegistry::UnRegisterSlateStyle(*Instance);
    ensure(Instance.IsUnique());
    Instance.Reset();
}

const class ISlateStyle& TestStyles::Get()
{
    return *Instance;
}

FName TestStyles::GetStyleSetName()
{
    static FName StyleSetName(TEXT("TestStyles"));
    return StyleSetName;
}

TSharedRef<class FSlateStyleSet> TestStyles::Create()
{
    return FSlateGameResources::New(TestStyles::GetStyleSetName(), "/game/ui", "/game/ui");
}

这里需要注意：FSlateGameResources 资源路径的相对位置。 /game 代替了 /context， 存放在 /context 目录下的资源，统一在地址路径中更名为 /game。

这个路径很重要！遇到错误的时候，一定要回来看看这个路径，看看能否找到 style 资源。

在这里，我没有按照网页中作者的方式创建 GameModule。（事实上我尝试了，但我失败了，暂时不想在此花费时间，所以改路。我放在了自定义的GameMode中）。

我认为只要能合理化的让 TestStyles 初始化，放哪都不是问题，（当然或许需要考虑创建的时序性，但目前我还没此顾虑）。

AMyGameMode::AMyGameMode()
{       
   this->HUDClass = AMyHUD::StaticClass();      
   FSlateStyleRegistry::UnRegisterSlateStyle(TestStyles::GetStyleSetName());// 参考网页的作者。只为防重复注册。       
   TestStyles::Initialize();
}

下面这个类，是由 UnrealEditor 向导生成的，操作如下：

在 Class 目录下创建 New Class。 

#pragma once


#include "Styling/SlateWidgetStyle.h"
#include "SlateWidgetStyleContainerBase.h"

#include "GlobalTestWidgetStyle.generated.h"

/**
 * 
 */
USTRUCT()
struct TEST05_API FGlobalTestStyle : public FSlateWidgetStyle
{
    GENERATED_USTRUCT_BODY()
public:

    FGlobalTestStyle();
    virtual ~FGlobalTestStyle();

    // FSlateWidgetStyle
    virtual void GetResources(TArray<const FSlateBrush*>& OutBrushes) const override;
    static const FName TypeName;
    virtual const FName GetTypeName() const override { return TypeName; };
    static const FGlobalTestStyle& GetDefault();

    UPROPERTY(EditAnywhere, Category = Appearance)
    FTextBlockStyle textBlockStyle;
};

/**
 */
UCLASS(hidecategories=Object, MinimalAPI)
class UGlobalTestWidgetStyle : public USlateWidgetStyleContainerBase
{
    GENERATED_BODY()

public:
    /** The actual data describing the widget appearance. */
    UPROPERTY(Category=Appearance, EditAnywhere, meta=(ShowOnlyInnerProperties))
    FGlobalTestStyle WidgetStyle;

    virtual const struct FSlateWidgetStyle* const GetStyle() const override
    {
        return static_cast< const struct FSlateWidgetStyle* >( &WidgetStyle );
    }
};

#include "Test05.h"
#include "GlobalTestWidgetStyle.h"


FGlobalTestStyle::FGlobalTestStyle()
{

}

FGlobalTestStyle::~FGlobalTestStyle()
{
}

const FName FGlobalTestStyle::TypeName(TEXT("FGlobalTestStyle"));

const FGlobalTestStyle& FGlobalTestStyle::GetDefault()
{
    static FGlobalTestStyle Default;
    return Default;
}

void FGlobalTestStyle::GetResources(TArray<const FSlateBrush*>& OutBrushes) const
{

}

　　

这里是重点， 我自己在作者的网页中没有看懂，最终咨询了同事后试验才找到正路。

在 Content 目录中创建 Style. 这个地址一定要是之前提到的 FSlateGameResources::New(  中使用的 地址，目前我用的是 /Game/ui 位置的地址，（参照上文解释）/Game/ui 的位置应该被替换成 /content/ui，如图：

在此创建：

得到一个 资源，这个名字也很重要，之后要对应上。

现在就双击修改里面的内容。

这个东西会存在，就是因为自定义的 FSlateWidgetStyle 中定义了 

 UPROPERTY(EditAnywhere, Category = Appearance)

 FTextBlockStyle textBlockStyle; 

这正是它。

我修改了字体和字体大小。

到了最后一步，实例化显示了，测试代码片段如下，我写在 

void AMyHUD::BeginPlay()
{                    
        // 注意，这里的 "TestButtonStyle01" 是资源的名字    
        auto ss = TestStyles::Get().GetWidgetStyle<FGlobalTestStyle>("TestButtonStyle01");  
        
       textBlock = SNew(STextBlock)   
                    .TextStyle(&ss.textBlockStyle)      
                    .Text(FText::FromString("Hello World !"));   
                         
      GEngine->GameViewport->AddViewportWidgetContent(SNew(SWeakWidget).PossiblyNullContent(textBlock.ToSharedRef()));            
}

所有步骤都做完了。可以显示了。效果如图：

原文中提到需要用到 Brush 的地方，以上代码不能工作，需要有其他步骤。测试成功后另写博文。

---

找到如何使Brush可用的方法：

void FGlobalTestStyle::GetResources(TArray<const FSlateBrush*>& OutBrushes) const
{
　　OutBrushes.Add(&m_brush);　　// 在这里添加需要的所有Brush,必须全部列出;
}