2.7 KiB
2.7 KiB
WBP_ItemViewBox
基本信息
- 类型: WidgetBlueprint (UserWidget)
- 父类: UserWidget
- 源文件: /Game/Blueprints/UI/Item/WBP_ItemViewBox.WBP_ItemViewBox
- 模块: Content/Blueprints/UI/Item
功能概述
物品视图盒子 Widget，用于在 UI 中展示单个物品的图标/外观。持有 ItemView（ItemView 类型）变量，GetBrush 函数返回 SlateBrush 用于渲染。4 个事件, 11 个节点。
设计用意
物品 UI 系统中的单个物品展示组件，通过 BP_ItemViewDataView 获取数据，通过 WBP_InventoryView 与库存视图联动。
职责范围
- 渲染单个物品的图标
- 通过 GetBrush 提供当前物品的 SlateBrush
项目内依赖
| 依赖项 | 关系 | 源文件 |
|---|---|---|
| WBP_InventoryView | 引用 | /Game/Blueprints/UI/Item/WBP_InventoryView |
| BP_InventoryComp | 引用 | /Game/Blueprints/Playground/BP_InventoryComp |
| BP_ItemViewDataView | 引用 | /Game/Blueprints/UI/Item/BP_ItemViewDataView |
外部视角
WBP_ItemViewBox 是 UserWidget 的子类，从外部调用者视角：
公开属性（蓝图可读写）
ItemView（FItemView 结构体）— 当前显示的物品视图数据
自定义函数
GetBrush()→FSlateBrush— 返回当前物品的 SlateBrush，用于渲染物品图标
外部交互方式
- 由 WBP_InventoryView 创建，作为物品列表中的单个条目
- 通过 BP_ItemViewDataView 获取物品数据
- 通过 BP_InventoryComp 获取物品视图数据
EventGraph 事件
| 事件 | 类型 | 触发时机 | 行为 |
|---|---|---|---|
事件预构造 |
原生覆盖 (PreConstruct) | Widget 创建时 | 预留（当前无连线逻辑） |
事件构造 |
原生覆盖 (Construct) | Widget 创建完成后 | 预留（当前无连线逻辑） |
事件Tick |
原生覆盖 | 每帧 | 预留（当前无连线逻辑） |
事件列表项目对象集上 |
接口事件 (UserListEntry) | 列表项数据绑定时 | 接收 BP_ItemViewDataView 对象 → Cast → 读取 Index → 从 WBP_InventoryView 的 Comp 获取 ItemViews → GET 对应索引 → 设置 ItemView |
使用方法
WBP_ItemViewBox 在项目中的典型调用流程：
- 列表项渲染流程 — WBP_InventoryView.UpdateListItems → 创建 WBP_ItemViewBox 作为列表子项 → 触发 OnListItemObjectSet → 从 BP_ItemViewDataView 读取 Index → 从 InventoryComp.GetItemViews 获取对应索引的 FItemView → 存入 ItemView 变量 → GetBrush 返回 SlateBrush 渲染图标
用例
| 引用方 | 路径 | 用途 |
|---|---|---|
| WBP_InventoryView | /Game/Blueprints/UI/Item/WBP_InventoryView |
作为列表项模板，渲染单个物品图标 |