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

3.2 KiB Raw Blame History Unescape Escape