UE C++基础 | UENUM枚举

最新推荐文章于 2026-04-10 11:02:10 发布

原创最新推荐文章于 2026-04-10 11:02:10 发布 · 1.6k 阅读

9 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

虚幻引擎

文章介绍了UEC++中UENUM用于声明枚举类型，以及如何使用UMETA改变编辑器显示名称。枚举的遍历方法包括ENUM_RANGE_BY_COUNT通过计数的最终值，ENUM_RANGE_BY_FIRST_AND_LAST按第一个和最后一个值，以及ENUM_RANGE_BY_VALUES按值顺序。此外，还展示了枚举转字符串的方法，通过StaticEnum获取枚举值的字符串表示。

文章目录

UE C++基础 | UENUM枚举

UE C++基础 | UENUM枚举

声明方式

UENUM(BlueprintType)
enum class EFood : uint8
{
	EApple,
	EBanana,
	EOrange
};

UMATA 标记

当使用UMETA更改编辑器中显示的枚举名字。

UENUM(BlueprintType)
enum class EFood : uint8
{
	EApple		UMETA(DisplayName = "Apple"),
	EBanana		UMETA(DisplayName = "Banana"),
	EOrange		UMETA(DisplayName = "Orange")
};

枚举的遍历

枚举计数宏

ENUM_RANGE_BY_COUNT（使用计数的最终值）(最常用的方式)

#include "Misc/EnumRange.h"

UENUM()
enum class EFood : uint8
{
	EApple		UMETA(DisplayName = "Apple"),
	EBanana		UMETA(DisplayName = "Banana"),
	EOrange		UMETA(DisplayName = "Orange")
    ECount      UMATA(Hidden)
};

ENUM_RANGE_BY_COUNT(EFood, EFood::ECount);

ENUM_RANGE_BY_FIRST_AND_LAST（按第一个和最后一个）

#include "Misc/EnumRange.h"

UENUM()
enum class EFood : uint8
{
	EApple		UMETA(DisplayName = "Apple"),
	EBanana		UMETA(DisplayName = "Banana"),
	EOrange		UMETA(DisplayName = "Orange")
};

ENUM_RANGE_BY_FIRST_AND_LAST(EFood, EFood::EApple, EFood::EOrange)

ENUM_RANGE_BY_COUNT（按值顺序）

#include "Misc/EnumRange.h"

enum class ERandomValues : uint8
{
First = 2,
Second = 3,
Third = 5,
Fourth = 7,
Fifth = 11
};

ENUM_RANGE_BY_VALUES(ERandomValues, ERandomValues::First, ERandomValues::Second, ERandomValues::Third, ERandomValues::Fourth, ERandomValues::Fifth)

遍历方式

for (EFood Food : TEnumRange<EFood>())
{

}

枚举转字符串

通过StaticEnum。

FString Name = StaticEnum<EFood>()->GetNameStringByValue(static_cast<__underlying_type(EFood)>(EFood::EBanana));

可以对其封装。

template<typename T>
FString EnumToString(const T EnumValue)
{
	FString Name = StaticEnum<T>()->GetNameStringByValue(static_cast<__underlying_type(T)>(EnumValue));
	check(Name.Len() != 0);
	return Name;
}