61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# 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` | 作为列表项模板，渲染单个物品图标 |
|