This commit is contained in:
meishibiezb
2026-06-05 03:01:15 +08:00
parent 29a3f77908
commit a8bdf281ff
41 changed files with 1935 additions and 779 deletions

View File

@@ -0,0 +1,59 @@
# 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` | 嵌入作为对话框环形进度显示组件 |