2.7 KiB
Raw Blame History

Instanced

  • 功能描述: 指定对该对象属性的编辑赋值应该新创建一个实例并作为子对象,而不是寻找一个对象引用。
  • 元数据类型: bool
  • 引擎模块: Instance
  • 限制类型: UObject*
  • 作用机制: 在PropertyFlags中加入CPF_PersistentInstance, CPF_ExportObject, CPF_InstancedReference在Meta中加入EditInline
  • 常用程度: ★★★

指定对该对象属性的编辑赋值应该新创建一个实例并作为子对象,而不是寻找一个对象引用。

  • 单个属性上的Instanced和UCLASS上的DefaultToInstanced作用有点类似区别是前者只作用于单个属性后者作用于该类类型的所有属性。
  • 常常和EditInlineNew一起使用在细节面板上可以为对象属性新创建实例并编辑。
  • Instanced隐含了EditInline and Export.

在Object*属性上设置值的时候如果不标Instanced则只能为其设置一个对象引用。而如果想在编辑器里为其真正的创建一个对象实例并赋予给这个属性则需要加上Instanced标记。但光有Instanced还不够这个Class还需要加上EditInlineNew才能让该类出现在可新创建类实例的列表里。

当然在C++里手动设置对象给这个属性的话还是都可以的。也要注意和UCLASS(DefaultToInstanced)区分DefaultToInstanced是表明这个类的所有属性都默认的加上Instanced的意思避免了对该类的所有属性每次都要手动设置。

示例代码:

UCLASS(Blueprintable, BlueprintType,editinlinenew)
class INSIDER_API UMyProperty_InstancedObject :public UDataAsset
{
public:
	GENERATED_BODY()
public:
	UPROPERTY(EditAnywhere, BlueprintReadWrite)
		int32 MyValue = 123;
};

UCLASS(Blueprintable, BlueprintType)
class INSIDER_API UMyProperty_Instanced :public UObject
{
public:
	GENERATED_BODY()
		UMyProperty_Instanced(const FObjectInitializer& ObjectInitializer = FObjectInitializer::Get());
public:
	//PropertyFlags:	CPF_Edit | CPF_BlueprintVisible | CPF_ExportObject | CPF_ZeroConstructor | CPF_InstancedReference | CPF_NoDestructor | CPF_PersistentInstance | CPF_HasGetValueTypeHash | CPF_NativeAccessSpecifierPublic 
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Instanced, Category = Behavior)
		UMyProperty_InstancedObject* ObjectInstanced;
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Behavior)
		UMyProperty_InstancedObject* Object;
};

示例效果:

可见ObjectInstanced和Object弹出的编辑框是不同的。

Untitled