UE4+C++开发-(七十五)-用C++代码动态创建一个ListView列表?

在 UE4.27 中动态生成列表视图(ListView)通常需要结合UListView控件和数据模型来实现。以下是具体步骤和实现方法:

1. 准备数据结构(Model)

首先需要定义一个数据类,用于存储列表项的数据(如文本、图标等)。这个类需要继承UObject并实现ITableRow所需的接口。

cpp

// .h 文件
#pragma once
#include "CoreMinimal.h"
#include "UObject/Object.h"
#include "MyListItemData.generated.h"

UCLASS()
class YOURPROJECT_API UMyListItemData : public UObject
{
    GENERATED_BODY()

public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite)
    FString ItemText;  // 列表项显示的文本

    UPROPERTY(EditAnywhere, BlueprintReadWrite)
    UTexture2D* ItemIcon;  // 列表项显示的图标(可选)
};

2. 创建列表项 Widget(User Widget)

设计列表项的 UI 样式,新建一个User Widget蓝图(如WB_ListItem),添加所需控件(如TextImage),并绑定数据显示逻辑。

  • 绑定数据:在蓝图中通过Bind节点将控件属性(如文本内容)与UMyListItemData中的字段关联。

3. 实现列表视图逻辑

在包含UListView的 Widget 蓝图或 C++ 类中,动态生成列表数据并绑定到 ListView。

蓝图实现步骤:
  1. 添加 ListView 控件在 UI 蓝图中放置ListView控件,并设置其Entry Class为步骤 2 创建的WB_ListItem
  2. 创建数据数组:在蓝图中创建UMyListItemData类型的数组,动态添加数据项。

    blueprint

    // 示例:动态生成5个列表项
    For Loop with Index (0 to 4)
        Create Widget (Class: UMyListItemData)
        Set ItemText to "Item " + Index
        Add to ListItemDataArray
    
  3. 绑定数据到 ListView:调用ListViewSet List Items节点,传入数据数组。
C++ 实现示例:

cpp

// .h 文件
#pragma once
#include "CoreMinimal.h"
#include "Blueprint/UserWidget.h"
#include "MyListViewWidget.generated.h"

UCLASS()
class YOURPROJECT_API UMyListViewWidget : public UUserWidget
{
    GENERATED_BODY()

protected:
    virtual void NativeConstruct() override;

private:
    UPROPERTY(meta = (BindWidget))
    class UListView* MyListView;  // 绑定UI中的ListView控件

    TArray<UObject*> ListItems;  // 存储列表项数据
};

// .cpp 文件
#include "MyListViewWidget.h"
#include "Components/ListView.h"
#include "MyListItemData.h"

void UMyListViewWidget::NativeConstruct()
{
    Super::NativeConstruct();

    // 动态生成列表数据
    for (int32 i = 0; i < 5; ++i)
    {
        UMyListItemData* NewItem = NewObject<UMyListItemData>();
        NewItem->ItemText = FString::Printf(TEXT("Item %d"), i);
        ListItems.Add(NewItem);
    }

    // 绑定数据到ListView
    if (MyListView)
    {
        MyListView->SetListItems(ListItems);
    }
}

4. 动态更新列表

若需要动态添加 / 删除列表项,可调用以下方法:

  • 添加项:向数据数组添加新的UMyListItemData对象,然后调用ListView->AddItem(NewItem)
  • 删除项:从数据数组中移除对象,然后调用ListView->RemoveItem(RemoveItem)
  • 刷新列表:调用ListView->RequestRefresh()强制刷新显示。

关键注意事项:

  1. UListViewEntry Class必须是继承UUserWidget的列表项蓝图。
  2. 数据类必须继承UObject,否则无法被 ListView 识别。
  3. 若列表项包含交互逻辑(如点击事件),可在列表项蓝图中添加Button并绑定回调。

通过以上步骤,即可在 UE4.27 中实现动态生成和管理列表视图。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值