属性

属性声明

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

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

Copy full snippet

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

核心数据类型

整数

整数数据类型转换是"int"或"uint"后跟位大小。

作为位掩码

整数属性现在可以位掩码形式公开给编辑器。要将整数属性标记为位掩码，只需在meta分段中添加"bitmask"即可，如下所示：

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

Copy full snippet

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

添加此元标记将使整数作为下拉列表形式可供编辑，它们使用笼统命名标记（"Flag 1"、"Flag 2"、"Flag 3"等等），可以 单独打开或关闭。

你也可以让蓝图可调用函数的整型参数表现为位掩码，方法是在参数的 UPARAM 指定器上添加 Bitmask 元标签（不需要值）。

	/*~ 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)

Copy full snippet

/*~ 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：

	UENUM(Meta = (Bitflags))
	enum class EColorBits
	{
		ECB_Red,
		ECB_Green,
		ECB_Blue
	};

Copy full snippet

UENUM(Meta = (Bitflags)) enum class EColorBits { ECB_Red, ECB_Green, ECB_Blue };

比特掩码枚举类型的范围是0到31，包括0和31。其对应于32位整型变量的位数（从第0位开始）。在上面的例子中，第0位是 ECB_Red，第1位是 ECB_Green，第2位是 ECB_Blue。

作为另一种声明方式，你可以使用 ENUM_CLASS_FLAGS 在定义完枚举类型后，将其变成一个位掩码。为了在编辑器中使用标志选择器（flag selector），我们还必须添加元字段 UseEnumValuesAsMaskValuesInEditor 并将其设置为 true。关键的区别在于，这个方法直接使用掩码值，而不是比特数。使用此方法制作的等效枚举类型看起来像这样：

	UENUM(Meta = (Bitflags, UseEnumValuesAsMaskValuesInEditor = "true"))
	enum class EColorBits
	{
		ECB_Red = 0x01,
		ECB_Green = 0x02,
		ECB_Blue = 0x04
	};

	ENUM_CLASS_FLAGS(EColorBits);
Copy full snippet

UENUM(Meta = (Bitflags, UseEnumValuesAsMaskValuesInEditor = "true")) enum class EColorBits { ECB_Red = 0x01, ECB_Green = 0x02, ECB_Blue = 0x04 }; ENUM_CLASS_FLAGS(EColorBits);

创建该UENUM后，可以使用"BitmaskEnum"元标记来引用它，如：

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

Copy full snippet

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

完成这个更改后，下拉框中列出的位标记将使用列举类条目的名称和值。在上述示例中， ECB_Red 值为0，表示它被选中时将激活位0（将ColorFlags增加1）。ECB_Green对应于位1（将ColorFlags增加2），ECB_Blue 对应于位2（将ColorFlags增加4）。

同样，你可以在 UPARAM 标签的meta部分添加 BitmaskEnum 和对应的枚举类型名称来定制它。

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

Copy full snippet

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

虽然列举类型包含超过32个条目，但在属性编辑器UI中，位掩码关联中只会看到前32个值。同样，虽然可接受显式值条目，但显式值介于0-31的条目不会包含在下拉列表中。

浮点类型

虚幻使用标准C++浮点类型、浮点和双精度。

布尔类型

布尔类型可以使用C++ ool关键字表示或表示为位域。

	uint32 bIsHungry : 1;
	bool bIsThirsty;

Copy full snippet

uint32 bIsHungry : 1; bool bIsThirsty;

字符串

虚幻引擎4支持三种核心类型的字符串。

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

对于大多数情况下，虚幻依靠TCHAR类型来表示字符。TEXT()宏可用于表示TCHAR文字。

	MyDogPtr->DogName = FName(TEXT("Samson Aloysius"));

Copy full snippet

MyDogPtr->DogName = FName(TEXT("Samson Aloysius"));

有关这三种字符串类型、何时使用哪个类型以及如何使用它们的更多信息，请参阅字符串处理文档。

属性说明符