Signal is a built-in Variant type that represents a signal of an Object instance. Like all Variant types, it can be stored in variables and passed to functions. Signals allow all connected Callables (and by extension their respective objects) to listen and react to events, without directly referencing one another. This keeps the code flexible and easier to manage. You can check whether an Object has a given signal name using Object.has_signal().
In GDScript, signals can be declared with the signal
keyword. In C#, you may use the [Signal]
attribute on a delegate.
Constructs an empty Signal with no object nor signal name bound.
Constructs a Signal as a copy of the given Signal.
Creates a Signal object referencing a signal named signal
in the specified object
.
Returns true
if the signals do not share the same object and name.
Returns true
if both signals share the same object and name.
Connects this signal to the specified callable
. Optional flags
can be also added to configure the connection's behavior (see ConnectFlags constants). You can provide additional arguments to the connected callable
by using Callable.bind().
A signal can only be connected once to the same Callable. If the signal is already connected, returns @GlobalScope.ERR_INVALID_PARAMETER and pushes an error message, unless the signal is connected with Object.CONNECT_REFERENCE_COUNTED. To prevent this, use is_connected() first to check for existing connections.
Disconnects this signal from the specified Callable. If the connection does not exist, generates an error. Use is_connected() to make sure that the connection exists.
Emits this signal. All Callables connected to this signal will be triggered. This method supports a variable number of arguments, so parameters can be passed as a comma separated list.
Returns an Array of connections for this signal. Each connection is represented as a Dictionary that contains three entries:
signal
is a reference to this signal;
callable
is a reference to the connected Callable;
flags
is a combination of ConnectFlags.
Returns the name of this signal.
Returns the object emitting this signal.
Returns the ID of the object emitting this signal (see Object.get_instance_id()).
Returns true
if any Callable is connected to this signal.
Returns true
if the specified Callable is connected to this signal.
Returns true
if this Signal has no object and the signal name is empty. Equivalent to signal == Signal()
.