Declaration [src]

g_signal_emit_by_name (
  GObject* instance,
  const gchar* detailed_signal,

Description [src]

Emits a signal. Signal emission is done synchronously. The method will only return control after all handlers are called or signal emission was stopped.

Note that g_signal_emit_by_name() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv().

This function is not directly available to language bindings.



Type: GObject

The instance the signal is being emitted on.

The data is owned by the caller of the function.

Type: const gchar*

A string of the form “signal-name::detail”.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.


Parameters to be passed to the signal, followed by a location for the return value. If the return type of the signal is G_TYPE_NONE, the return value location can be omitted. The number of parameters to pass to this function is defined when creating the signal.