Declaration [src]

g_signal_handler_find (
  GObject* instance,
  GSignalMatchType mask,
  guint signal_id,
  GQuark detail,
  GClosure* closure,
  gpointer func,
  gpointer data

Description [src]

Finds the first signal handler that matches certain selection criteria. The criteria mask is passed as an OR-ed combination of GSignalMatchType flags, and the criteria values are passed as arguments. The match mask has to be non-0 for successful matches. If no handler was found, 0 is returned.


instance GObject

The instance owning the signal handler to be found.

 The data is owned by the caller of the function.
mask GSignalMatchType

Mask indicating which of signal_id, detail, closure, func and/or data the handler has to match.

signal_id guint

Signal the handler has to be connected to.

detail GQuark

Signal detail the handler has to be connected to.

closure GClosure

The closure the handler will invoke.

 The argument can be NULL.
 The data is owned by the caller of the function.
func gpointer

The C closure callback of the handler (useless for non-C closures).

data gpointer

The closure data of the handler’s closure.

Return value

Returns: gulong

A valid non-0 signal handler id for a successful match.