Function

GObjectsignal_emit_by_name

Declaration

void
g_signal_emit_by_name (
  GObject* instance,
  const gchar* detailed_signal,
  ...
)

Description

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.

Parameters

instance

Type: GObject

The instance the signal is being emitted on.

The data is owned by the caller of the function.

detailed_signal

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.

...

Type:

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.