# 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 木桶交互窗口 |