# WBP_Circle ## 基本信息 - **类型**: WidgetBlueprint (UserWidget) - **父类**: UserWidget - **源文件**: /Game/Blueprints/UI/Dialog/WBP_Circle.WBP_Circle - **模块**: Content/Blueprints/UI/Dialog ## 功能概述 环形进度条 Widget,用于显示精度/进度值。提供 `设置精度条(Value: float)` 函数设置进度值。EventGraph 含 3 个事件和 3 个节点。 ## 设计用意 对话框系统中的 UI 辅助组件,以环形进度条形式展示某个数值状态(如对话计时、资源进度等)。 ## 职责范围 - 渲染环形进度条 - 通过 `设置精度条` 函数更新当前进度值 ## 项目内依赖 | 依赖项 | 关系 | 源文件 | |--------|------|--------| | 血条框1 | 引用(纹理) | /Game/Arts/UI/纹理/血条框1 | | 环型血条_Inst | 引用(材质) | /Game/Arts/UI/血条/环型血条_Inst | ## 外部视角 WBP_Circle 是 UserWidget 的子类,从外部调用者视角: **自定义函数** - `设置精度条(Value: float)` — 更新环形进度条的当前值 **接口概览** - 无公开变量 - 仅提供单个公开函数用于更新进度值 - EventGraph 极简(3 事件, 3 节点),无额外事件处理 **外部交互方式** - 由 WBP_Module1 创建并嵌入 - 外部通过 Widget 引用调用 `设置精度条` 更新进度显示 **EventGraph 事件** | 事件 | 类型 | 触发时机 | 行为 | |------|------|----------|------| | `事件预构造` | 原生覆盖 (PreConstruct) | Widget 创建时 | 预留(当前无连线逻辑) | | `事件构造` | 原生覆盖 (Construct) | Widget 创建完成后 | 预留(当前无连线逻辑) | | `事件Tick` | 原生覆盖 | 每帧 | 预留(当前无连线逻辑) | ## 使用方法 WBP_Circle 在项目中的使用方式: - **WBP_Module1**(`/Game/Blueprints/UI/WBP_Module1`)— 作为子 Widget 嵌入,在 UI 模块中显示环形进度 ## 用例 | 引用方 | 路径 | 用途 | |--------|------|------| | WBP_Module1 | `/Game/Blueprints/UI/WBP_Module1` | 嵌入作为对话框环形进度显示组件 |