官术网_书友最值得收藏!

Creating a USTRUCT

You may want to construct a Blueprints editable property in UE4 that contains multiple members. The FColoredTexture struct that we will create in this chapter will allow you to group together a texture and its color inside the same structure for inclusion and specification in any other UObject derivative, Blueprintable class:

The FColoredTexture structure does have the visual within Blueprints appearance as shown in the figure above.

This is for good organization and convenience of your other UCLASS UPROPERTIES(). You may want to construct a C++ structure in your game using the keyword struct.

Getting ready

A UObject is the base class of all UE4 class objects, while an FStruct is just any plain old C++ style struct. All objects that use the automatic memory management features within the engine must derive from this class.

Tip

If you' recall from the C++ language, the only difference between a C++ class and a C++ struct is that C++ classes have default private members, while structs default to public members. In languages like C#, this isn't the case. In C#, a struct is value-typed, while a class is reference-typed.

How to do it...

We'll create a structure FColoredTexture in C++ code to contain a texture and a modulating color:

  1. Create a file ColoredTexture.h in your project folder (not FColoredTexture).
  2. ColoredTexture.h contains the following code:
    #pragma once
    
    #include "Chapter2.h"
    #include "ColoredTexture.generated.h"
    
    USTRUCT()
    struct CHAPTER2_API FColoredTexture
    {
      GENERATED_USTRUCT_BODY()
      public:
      UPROPERTY( EditAnywhere, BlueprintReadWrite, Category = HUD )
      UTexture* Texture;
      UPROPERTY( EditAnywhere, BlueprintReadWrite, Category = HUD )
      FLinearColor Color;
    };
  3. Use ColoredTexture.h as a UPROPERTY() in some Blueprintable UCLASS(), using a UPROPERTY() declaration like this:
    UPROPERTY( EditAnywhere, BlueprintReadWrite, Category = HUD )
    FColoredTexture* Texture;

How it works...

The UPROPERTY() specified for the FColoredTexture will show up in the editor as editable fields when included as UPROPERTY() fields inside another class, as shown in step 3.

There's more…

The main reason for making a struct a USTRUCT() instead of just a plain old C++ struct is to interface with the UE4 Engine functionality. You can use plain C++ code (without creating USTRUCT() objects) for quick small structures that don't ask the engine to use them directly.

主站蜘蛛池模板: 涿州市| 丹阳市| 右玉县| 长治市| 湖南省| 政和县| 富平县| 正阳县| 新平| 江西省| 吴川市| 舟曲县| 吴桥县| 磐安县| 华坪县| 曲阳县| 宜章县| 霞浦县| 蓬莱市| 阳新县| 仙游县| 恩施市| 通道| 衡水市| 寻甸| 滕州市| 威海市| 巴里| 开江县| 怀仁县| 谢通门县| 新乐市| 晋宁县| 阜平县| 桂阳县| 顺昌县| 东安县| 上杭县| 南阳市| 阜宁县| 平江县|