在 Unreal Engine 的 C++ 中，FScriptDelegate 是用于处理委托（Delegate） 的基础结构，主要作用是绑定函数到委托实例，实现回调机制。它是 UE 中实现事件驱动编程的核心工具之一，尤其常用于 UI 交互、异步操作回调等场景。

核心作用

FScriptDelegate 本质是一个 "函数指针的包装器"，用于将一个对象的成员函数与委托关联起来。当委托被广播（Broadcast）时，所有绑定的函数会被自动调用。

它通常与 FMulticastDelegate（多播委托）配合使用，支持多个函数绑定到同一个委托上（一对多的回调关系）。

基本用法

以 UI 按钮点击事件为例（UButton 的 OnClicked 是一个多播委托）：

cpp

运行

// 1. 声明回调函数（在类中）
void UMyWidget::OnButtonClicked()
{
    UE_LOG(LogTemp, Log, TEXT("按钮被点击了！"));
}

// 2. 绑定函数到委托
void UMyWidget::BindButtonEvent()
{
    // 获取按钮控件
    UButton* MyButton = Cast<UButton>(GetWidgetFromName(TEXT("MyButton")));
    if (MyButton)
    {
        // 创建 FScriptDelegate 实例
        FScriptDelegate ButtonDelegate;
        
        // 绑定当前对象的 OnButtonClicked 函数
        ButtonDelegate.BindUObject(this, &UMyWidget::OnButtonClicked);
        
        // 将委托添加到按钮的 OnClicked 多播委托中
        MyButton->OnClicked.Add(ButtonDelegate);
    }
}

关键方法

1. BindUObject
   绑定一个 UObject 派生类的成员函数，是最常用的绑定方式：

   cpp

   运行

   ButtonDelegate.BindUObject(目标对象指针, &类名::函数名);
   

    

   示例：ButtonDelegate.BindUObject(this, &UMyWidget::OnButtonClicked);

2. IsBound
   检查委托是否已成功绑定函数：

   cpp

   运行

   if (ButtonDelegate.IsBound())
   {
       // 委托已绑定，可以安全调用
   }
   

3. Execute
   直接执行委托绑定的函数（通常用于单播委托）：

   cpp

   运行

   if (ButtonDelegate.IsBound())
   {
       ButtonDelegate.Execute(); // 执行绑定的 OnButtonClicked 函数
   }
   

与 AddDynamic 的关系

在 UE 中，你可能更常看到 AddDynamic 宏（如 Button->OnClicked.AddDynamic(this, &UMyWidget::OnClicked)），它本质是 FScriptDelegate 的简化封装：

• AddDynamic 内部会自动创建 FScriptDelegate 实例。
• 自动完成绑定和添加到多播委托的过程，减少代码量。

FScriptDelegate 是更底层的实现，而 AddDynamic 是更便捷的上层接口。

适用场景

• UI 交互：按钮点击、滑块拖动、文本框输入变化等事件。
• 异步操作：文件加载完成、网络请求返回、动画播放结束等回调。
• 自定义事件：在游戏逻辑中定义委托，实现模块间解耦（如角色受伤时通知 HUD 更新血条）。

注意事项

• 绑定的函数必须是 UObject 派生类的成员函数（非静态函数）。
• 委托绑定后，若目标对象被销毁，需手动移除绑定（否则可能导致崩溃）。使用 AddDynamic 时，UE 会自动处理对象销毁后的解绑。
• 函数参数需与委托声明的参数列表一致（例如，带参数的委托需要绑定带对应参数的函数）。

总结：FScriptDelegate 是 UE 委托机制的基础组件，负责函数与委托的绑定和执行，是实现事件驱动和模块解耦的核心工具。日常开发中，AddDynamic 等宏已封装了其复杂逻辑，但理解 FScriptDelegate 有助于深入掌握 UE 的委托系统。