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