update

Content/Blueprints/WBP_Window.md

@@ -0,0 +1,66 @@
+# WBP_Window
+
+## 基本信息
+- **类型**: WidgetBlueprint (UserWidget)
+- **父类**: UserWidget
+- **源文件**: /Game/Blueprints/UI/WBP_Window.WBP_Window
+- **模块**: Content/Blueprints/UI
+
+## 功能概述
+可拖拽窗口 Widget，实现了一个具有标题栏的基本窗口 UI。支持鼠标拖拽移动（通过 On_Title_Bar_MouseButtonDown/Up 和 UpdatePosition 函数），持有 IsDragging（bool）、DragStartPoint（Vector2D）、WidgetStartPoint（Vector2D）、IsTemp（bool）四个变量管理拖拽状态。
+
+## 设计用意
+提供一个可复用的通用窗口 UI 组件，支持标题栏拖拽移动。作为游戏内各类面板的基础容器，被 BP_Hud、BP_Barrel 等持有使用。
+
+## 职责范围
+- 渲染窗口标题栏和内容区域
+- 管理窗口的拖拽移动逻辑
+- 标识是否为临时窗口（IsTemp）
+
+## 项目内依赖
+| 依赖项 | 关系 | 源文件 |
+|--------|------|--------|
+| （无） | — | — |
+
+## 外部视角
+
+WBP_Window 是 UserWidget 的子类，从外部调用者视角：
+
+**公开属性（蓝图可读写）**
+- `IsDragging`（bool）— 当前是否在拖拽状态
+- `DragStartPoint`（Vector2D）— 拖拽起始鼠标位置
+- `WidgetStartPoint`（Vector2D）— 拖拽起始 Widget 位置
+- `IsTemp`（bool）— 是否为临时窗口
+
+**公开函数**
+- `On_Title_Bar_MouseButtonDown(Geometry, PointerEvent)` → `FEventReply` — 标题栏按下，启动拖拽
+- `On_Title_Bar_MouseButtonUp(Geometry, PointerEvent)` → `FEventReply` — 标题栏释放，结束拖拽
+- `UpdatePosition()` — 根据拖拽偏移更新 Widget 位置
+
+**外部交互方式**
+- 由 BP_Hud 或 BP_Barrel 创建并持有，作为通用窗口容器
+- 外部系统通过 Widget 引用设置内容或控制显示/隐藏
+
+**EventGraph 事件**
+
+| 事件 | 类型 | 触发时机 | 行为 |
+|------|------|----------|------|
+| `事件预构造` | 原生覆盖 (PreConstruct) | Widget 在编辑器中放置或运行时创建时 | 预留（当前无连线逻辑） |
+| `事件构造` | 原生覆盖 (Construct) | Widget 创建完成后 | 预留（当前无连线逻辑） |
+| `事件Tick` | 原生覆盖 | 每帧 | 如果 IsDragging=true → 调用 UpdatePosition 更新窗口位置 |
+| `On Clicked (Button_61)` | 组件绑定事件 | 用户点击关闭按钮时 | 如果 IsTemp=true → 从父项中移除（销毁临时窗口），否则 → 设置可视性为 Hidden（隐藏持久窗口） |
+
+## 使用方法
+
+WBP_Window 在项目中的典型调用流程：
+
+- **窗口拖拽流程** — 用户按住标题栏 → On_Title_Bar_MouseButtonDown 记录拖拽起始位置 → Tick 检测 IsDragging → UpdatePosition 根据鼠标偏移移动 Widget → 释放 → On_Title_Bar_MouseButtonUp 结束拖拽
+- **临时窗口关闭流程** — 用户点击关闭按钮 → On Clicked (Button_61) → 判断 IsTemp → 临时窗口直接从父项移除，持久窗口仅隐藏
+- **HUD 窗口创建流程** — BP_Hud.BeginPlay → 创建 WBP_Window（InventoryWindow/HintWindow）→ 添加到视口 → 外部通过 BP_Hud 变量访问
+
+## 用例
+
+| 引用方 | 路径 | 用途 |
+|--------|------|------|
+| BP_Hud | `/Game/Blueprints/BP_Hud` | 作为 InventoryWindow/HintWindow 窗口容器 |
+| BP_Barrel | `/Game/Blueprints/Playground/BP_Barrel` | 作为 BarrelWindow 木桶交互窗口 |