Function

GObjectsignal_handler_find

Declaration

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

Description

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.

Parameters

`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).
	The argument can be `NULL`.
`data`	`gpointer`
	The closure data of the handler’s closure.
	The argument can be `NULL`.

Return value

Returns:	`gulong`
	A valid non-0 signal handler id for a successful match.