UE_C++ —— Properties

目录

一，Property Declaration

二，核心数据类型

Integers

Floating Point Types

Boolean Types

Strings

三，Property Specifiers

四，Metadata Specifiers

一，Property Declaration

        Properties 属性使用标准的C++变量语法声明，前面用 UPROPERTY 宏来定义属性变量说明符和元数据；

UPROPERTY([specifier, specifier, ...], [meta(key = value, key = value, ...)])
Type VariableName;

二，核心数据类型

Integers

• uint8、uint16、uint32、uint64
• int8、int16、int32、int64

• As Bitmasks，元标记可使整数作为下拉列表形式可供编辑；

/*~ BasicBits appears as a list of generic flags in the editor, instead of an integer field. */
UPROPERTY(EditAnywhere, Meta = (Bitmask))
int32 BasicBits;

/*~ You can set MyFunction using a generic list of flags instead of typing in an integer value. */
UFUNCTION(BlueprintCallable)
void MyFunction(UPARAM(meta = (Bitmask)) int32 BasicBitsParam)

//自定义bitflags名称
UENUM(Meta = (Bitflags))
enum class EColorBits
{
	ECB_Red,
	ECB_Green,
	ECB_Blue
};

//将定义好的枚举转化为bitmask
UENUM(Meta = (Bitflags, UseEnumValuesAsMaskValuesInEditor = "true"))
enum class EColorBits
{
	ECB_Red  = 0x01,
	ECB_Green = 0x02,
	ECB_Blue  = 0x04
};

ENUM_CLASS_FLAGS(EColorBits);

//定义好后引用
/*~ This property lists flags matching the names of values from EColorBits. */
UPROPERTY(EditAnywhere, Meta = (Bitmask, BitmaskEnum = "EColorBits"))
int32 ColorFlags;

/*~ MyOtherFunction shows flags named after the values from EColorBits. */
UFUNCTION(BlueprintCallable)
void MyOtherFunction(UPARAM(meta = (Bitmask, BitmaskEnum = "EColorBits")) int32 ColorFlagsParam)

Floating Point Types

• float
• double

Boolean Types

• 可使用C++ bool关键字或位域；

uint32 bIsHungry : 1;
bool bIsThirsty;

Strings

支持三种核心类型的字符串：

• FString 是典型的"动态字符数组"字符串类型；
• FName 是对全局字符串表中不可变且不区分大小写的字符串的引用；相较于FString，它的大小更小，更能高效的传递，但更难以操控；
• FText 是指定用于处理本地化的更可靠的字符串表示；

//大多数情况下，使用TCHAR类型来表示字符，TEXT()宏可用于表示TCHAR文字；
MyDogPtr->DogName = FName(TEXT("Samson Aloysius"));

三，Property Specifiers

        声明属性时，可添加属性说明符以控制属性行为；

四，Metadata Specifiers

        声明类、接口、结构体、枚举、枚举值、函数，或属性时，可添加 元数据说明符 来控制其与引擎和编辑器各方面的相处方式；每一种类型的数据结构或成员都有自己的元数据说明符列表；

注，Metadata只存在于编辑器中，不要编写能够访问到Metadata的游戏逻辑；