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 GObject
 

The instance the signal is being emitted on.

 The data is owned by the caller of the function.
detailed_signal 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.