loneseDocument/Content/Blueprints/WBP_ChoiceButton.md

WBP_ChoiceButton

基本信息

• 类型: WidgetBlueprint (UserWidget)
• 父类: UserWidget
• 源文件: /Game/Blueprints/UI/Dialog/WBP_ChoiceButton.WBP_ChoiceButton
• 模块: Content/Blueprints/UI/Dialog

功能概述

对话选项按钮 Widget，用于对话框系统中的分支选择。持有 Executor（interface）、Name（FName）、ButtonText（FText）三个变量。InitButton 函数初始化按钮的 executor、名称和文本，Get_Text_Text 返回按钮显示文本。

设计用意

对话框系统中用于呈现玩家可选分支的 UI 按钮，通过 Executor 接口与对话执行器通信，Name 标识选项标识符。

职责范围

• 渲染对话框分支选项按钮
• 通过 Executor 接口将选项选择结果传递给对话执行系统

项目内依赖

依赖项	关系	源文件
（无）	—	—

外部视角

WBP_ChoiceButton 是 UserWidget 的子类，从外部调用者视角：

公开属性（蓝图可读写）

• Executor（接口引用）— 对话执行器接口
• Name（FName）— 选项标识符
• ButtonText（FText）— 按钮显示文本

自定义函数

• InitButton(InEx(接口), InName(FName), InText(FText)) — 初始化按钮的执行器、名称和文本
• Get_Text_Text() → FText — 返回按钮的显示文本（用作绑定）

外部交互方式

• 由 WBP_TestUI（对话框 UI）在 SummonChoiceButtons 中动态创建
• 点击按钮时通过 Executor 接口将选择结果传递给对话执行系统

EventGraph 事件

事件	类型	触发时机	行为
事件预构造	原生覆盖 (PreConstruct)	Widget 创建时	预留（当前无连线逻辑）
事件构造	原生覆盖 (Construct)	Widget 创建完成后	预留（当前无连线逻辑）
事件Tick	原生覆盖	每帧	预留（当前无连线逻辑）
On Clicked (MainButton)	组件绑定事件	用户点击按钮时	获取 Executor → 获取 Name → 通过 UDialogPresentationSubsystem 调用 ShowDialog 传递选择结果

使用方法

WBP_ChoiceButton 在项目中的典型调用流程：

• 选项生成流程 — WBP_TestUI.SummonChoiceButtons → 动态创建 WBP_ChoiceButton 实例 → InitButton 设置 Executor/Name/ButtonText → 挂接到面板
• 选项选择流程 — 用户点击按钮 → On Clicked (MainButton) → 获取 Executor 接口和 Name → 通过 UDialogPresentationSubsystem.ShowDialog 传递选择

用例

引用方	路径	用途
WBP_TestUI	/Game/Blueprints/UI/Dialog/WBP_TestUI	动态生成并初始化，用于玩家对话分支选择