60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# 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` | 嵌入作为对话框环形进度显示组件 |
|