mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
68 lines
2.1 KiB
C#
68 lines
2.1 KiB
C#
// Copyright (c) 2025-2026 GeWuYou
|
||
// SPDX-License-Identifier: Apache-2.0
|
||
|
||
using Godot;
|
||
|
||
namespace GFramework.Godot.Extensions.Signal;
|
||
|
||
/// <summary>
|
||
/// 信号连接构建器，用于以流畅的方式连接Godot信号
|
||
/// </summary>
|
||
/// <param name="target">要连接信号的目标节点</param>
|
||
/// <param name="signal">要连接的信号名称</param>
|
||
public sealed class SignalBuilder(GodotObject target, StringName signal)
|
||
{
|
||
private GodotObject.ConnectFlags? _flags;
|
||
|
||
/// <summary>
|
||
/// 设置连接标志
|
||
/// </summary>
|
||
/// <param name="flags">连接标志</param>
|
||
/// <returns>当前构建器实例</returns>
|
||
public SignalBuilder WithFlags(GodotObject.ConnectFlags flags)
|
||
{
|
||
_flags = flags;
|
||
return this;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 连接信号到指定的可调用对象
|
||
/// </summary>
|
||
/// <param name="callable">要连接的可调用对象</param>
|
||
/// <param name="flags">连接标志</param>
|
||
/// <returns>当前构建器实例</returns>
|
||
public SignalBuilder To(Callable callable, GodotObject.ConnectFlags? flags = null)
|
||
{
|
||
var finalFlags = flags ?? _flags;
|
||
// 根据是否设置了标志来决定连接方式
|
||
if (finalFlags is null)
|
||
target.Connect(signal, callable);
|
||
else
|
||
target.Connect(signal, callable, (uint)finalFlags);
|
||
|
||
return this;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 连接信号到指定的可调用对象并立即调用
|
||
/// </summary>
|
||
/// <param name="callable">要连接的可调用对象</param>
|
||
/// <param name="flags">连接标志</param>
|
||
/// <param name="args">调用参数</param>
|
||
/// <returns>当前构建器实例</returns>
|
||
public SignalBuilder ToAndCall(Callable callable, GodotObject.ConnectFlags? flags = null, params Variant[] args)
|
||
{
|
||
To(callable, flags);
|
||
callable.Call(args);
|
||
return this;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 显式结束，返回 Node
|
||
/// </summary>
|
||
/// <returns>目标节点</returns>
|
||
public GodotObject End()
|
||
{
|
||
return target;
|
||
}
|
||
} |