【UE5】UMG C++父类绑定蓝图子类属性

有时我们在设计UMG时可能会使用到C++父类来处理一些通用逻辑,如果我们想要在C++父类中获取其派生子类的某个属性,如Image或Button等,我们可以通过使用UE提供的BindWidget元数据标签的方式来获取。

BindWidget

BindWidget元数据标签在官方文档中并没有出现,但引擎是支持这个标签的。

在看例子之前我们需要注意一些BindWidget的要求:

  • BindWidget标识的变量必须是public变量;
  • BindWidget标识的变量必须是UWidget类型及其派生类型;
  • BindWidget标识的变量必须是指针;
  • 蓝图子类中必须存在同类型的同名控件。

首先我们创建一个继承自UUserWidget的自定义C++类UCusWidget,然后创建一个public变量,然后在UPROPERTY中设置BindWidget元数据:

c++ 复制代码
UCLASS()
class MYPROJECT_API UCusWidget : public UUserWidget
{
	GENERATED_BODY()
public:
	UPROPERTY(BlueprintReadWrite, Meta = (BindWidget),Category = "CusWidget")
	UImage* CusImage;
	UPROPERTY(BlueprintReadWrite, Meta = (BindWidget),Category = "CusWidget")
	UTextBlock* CusText;

	virtual void NativeConstruct() override;
};

然后创建一个继承自UCusWidget的UMG蓝图UW_Cus,为UI添加一个Image并命名为CusImage,添加一个TextBlock并命名为CusText:

这样控件CusImage和CusText就和父类中的同名变量绑定了,如此父类便可以通过同名变量来控制子类的控件了。

这里我们在Widget构造时给与CusImage一个随机颜色并在CusText中显示颜色的RGBA值:

c++ 复制代码
void UCusWidget::NativeConstruct()
{
	Super::NativeConstruct();
	if(CusImage)
	{
		CusImage->SetColorAndOpacity(FLinearColor::MakeRandomColor());
	}
	if(CusText)
	{
		CusText->SetText(FText::FromString(CusImage->ColorAndOpacity.ToString()));
	}
}

然后就可以看到结果了:

这里我在另一个Widget中封装了多个UW_Cus以便观察。

这里有一个坑需要注意,更新控件属性时应该使用对应的Set函数,如:CusImage->SetColorAndOpacity(FLinearColor::MakeRandomColor()),而不是直接赋值,如:CusImage->ColorAndOpacity = FLinearColor::MakeRandomColor(),直接赋值Widget不会更新样式。

BindWidgetOptional

BindWidget元数据需要强制绑定子蓝图的同名控件,而BindWidgetOptional功能上和BindWidget一致,但不需要强制绑定子蓝图中的同名控件,所以这就要求在书写C++代码时需要更严谨,因为它们修饰的变量都是指针,而使用BindWidgetOptional极容易出现空指针。

BindWidgetAnim

BindWidgetAnim是专门用来绑定UWidgetAnimation类型变量的元数据,和BindWidget一样,BindWidgetAnim对变量也有要求:

  • BindWidgetAnim标识的变量必须是public变量;
  • BindWidgetAnim标识的变量必须是UWidgetAnimation类型及其派生类型;
  • BindWidgetAnim标识的变量必须是指针;
  • BindWidgetAnim标识的变量必须是Transient变量;
  • 蓝图子类中必须存在同名的Widget动画。

关于Transient,Transient也是一个UPROPERTY的标识符,用于标识变量是否是临时变量,被标识的变量会被禁止序列化,如:

c++ 复制代码
UCLASS()
class MYPROJECT_API UCusWidget : public UUserWidget
{
	GENERATED_BODY()
public:
	UPROPERTY(BlueprintReadWrite, Meta = (BindWidgetOptional),Category = "CusWidget")
	UImage* CusImage;
	UPROPERTY(BlueprintReadWrite, Meta = (BindWidgetOptional),Category = "CusWidget")
	UTextBlock* CusText;
	UPROPERTY(BlueprintReadWrite,Transient, Meta = (BindWidgetAnim),Category = "CusWidget")
	UWidgetAnimation* StartAnime;

	virtual void NativeConstruct() override;	
};

BindWidgetAnimOptional

BindWidgetAnimOptional功能和BindWidgetOptional一样,用于非强制绑定动画的情况;

UE元数据参考

https://benui.ca/unreal/uproperty/#umg

相关推荐
野曙1 分钟前
快速选择算法:优化大数据中的 Top-K 问题
大数据·数据结构·c++·算法·第k小·第k大
LallanaLee3 分钟前
常见面试题
java·开发语言
休息一下接着来18 分钟前
C++ 条件变量与线程通知机制:std::condition_variable
开发语言·c++·算法
爱学习的小邓同学19 分钟前
C++ --- new与delete
c++
爱尚你199328 分钟前
Java 泛型与类型擦除:为什么解析对象时能保留泛型信息?
java
努力学习的小廉42 分钟前
【C++】 —— 笔试刷题day_29
开发语言·c++·算法
电商数据girl1 小时前
酒店旅游类数据采集API接口之携程数据获取地方美食品列表 获取地方美餐馆列表 景点评论
java·大数据·开发语言·python·json·旅游
CircleMouse1 小时前
基于 RedisTemplate 的分页缓存设计
java·开发语言·后端·spring·缓存
ktkiko111 小时前
顶层架构 - 消息集群推送方案
java·开发语言·架构
zybsjn1 小时前
后端系统做国际化改造,生成多语言包
java·python·c#