Function

GObjectSignalEmissionHook

Declaration

gboolean
(* GSignalEmissionHook) (
  GSignalInvocationHint* ihint,
  guint n_param_values,
  const GValue* param_values,
  gpointer data
)

Description [src]

A simple function pointer to get invoked when the signal is emitted.

Emission hooks allow you to tie a hook to the signal type, so that it will trap all emissions of that signal, from any object.

You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag.

Parameters

ihint GSignalInvocationHint
 

Signal invocation hint, see GSignalInvocationHint.

 The data is owned by the caller of the function.
n_param_values guint
 

The number of parameters to the function, including the instance on which the signal was emitted.

param_values An array of GValue
 

The instance on which the signal was emitted, followed by the parameters of the emission.

 The length of the array is specified in the n_param_values argument.
 The data is owned by the caller of the function.
data gpointer
 

User data associated with the hook.

Return value

Returns: gboolean
 

Whether it wants to stay connected. If it returns FALSE, the signal hook is disconnected (and destroyed).