UE4 如何使用UMG ListView展示UStruct结构体数组内容

解决方案 #

方案1：轻量UObject包装（官方推荐常规做法，无冗余） #

UE的UMG ListView设计上确实只支持UObject类型的条目数据，你担心的“虚拟UObject冗余”完全是多虑的，我们可以做一个仅用于UI层数据绑定的轻量包装类，完全不侵入你现有的存档逻辑：

1. 定义一个仅包含单条高分记录结构体的UObject子类：

UCLASS(BlueprintType)
class UHighScoreListItem : public UObject
{
    GENERATED_BODY()
public:
    // 直接存储高分结构体实例
    UPROPERTY(BlueprintReadWrite, Category = "HighScore")
    FHighScoreEntry ScoreData;

    // 快速创建包装对象的静态方法
    static UHighScoreListItem* CreateFromEntry(const FHighScoreEntry& InEntry)
    {
        UHighScoreListItem* ListItem = NewObject<UHighScoreListItem>();
        ListItem->ScoreData = InEntry;
        return ListItem;
    }
};

2. 给ListView填充数据时，遍历你原本的TArray<FHighScoreEntry> HighScores数组，逐个生成包装对象传入ListView即可：

TArray<UObject*> ListItems;
for (const auto& Entry : HighScores)
{
    ListItems.Add(UHighScoreListItem::CreateFromEntry(Entry));
}
MyListView->SetListItems(ListItems);

3. 实现IUserObjectListEntry的OnListItemObjectSet方法时，直接把传入的UObject转成UHighScoreListItem，取ScoreData字段绑定UI控件即可。

这个方案的优势是：你原本的SaveGame存储逻辑完全不用改，还是直接存结构体数组，不存在存指针失效的问题，UI层和数据层完全分离，额外的性能开销可以忽略不计。 #

方案2：手动生成列表条目（完全不需要额外UObject） #

如果你的高分榜条目数量不多（通常最多几十条），完全可以不用ListView的自动绑定逻辑，直接用VerticalBox手动生成条目：

1. 给你的条目控件加一个初始化方法，参数直接接收FHighScoreEntry类型的结构体，在方法内完成UI绑定。
2. 遍历HighScores数组，逐个创建条目控件实例，调用初始化方法传入结构体，再添加到VerticalBox的子节点即可。

这个方案不需要实现任何接口，也完全不用创建额外的UObject，逻辑更直接。 #

额外说明 #

不存在专门适配结构体的ListView入口接口，轻量UObject包装是UE开发中的常规操作，不属于冗余设计。如果你想直接在SaveGame中存UObject数组，只要UObject的所有成员都标记了UPROPERTY，SaveGame序列化时会自动序列化成员数据，不会只存指针，你之前出现的失效问题大概率是没有正确标记UObject的成员属性。

内容的提问来源于stack exchange，提问作者Curtwagner1984