Function
GObjectsignal_handlers_unblock_matched
Declaration
guint
g_signal_handlers_unblock_matched (
GObject* instance,
GSignalMatchType mask,
guint signal_id,
GQuark detail,
GClosure* closure,
gpointer func,
gpointer data
)
Description
Unblocks all handlers on an instance that match a certain selection criteria.
The criteria mask is passed as a combination of GSignalMatchType flags, and
the criteria values are passed as arguments. A handler must match on all
flags set in mask to be unblocked (i.e. the match is conjunctive).
Passing at least one of the G_SIGNAL_MATCH_ID, G_SIGNAL_MATCH_CLOSURE,
G_SIGNAL_MATCH_FUNC
or G_SIGNAL_MATCH_DATA match flags is required for successful matches.
If no handlers were found, 0 is returned, the number of unblocked handlers
otherwise. The match criteria should not apply to any handlers that are
not currently blocked.
Support for G_SIGNAL_MATCH_ID was added in GLib 2.78.
Parameters
instance-
Type:
GObjectThe instance to unblock handlers from.
The data is owned by the caller of the function. mask-
Type:
GSignalMatchTypeMask indicating which of
signal_id,detail,closure,funcand/ordatathe handlers have to match. signal_id-
Type:
guintSignal the handlers have to be connected to.
detail-
Type:
GQuarkSignal detail the handlers have to be connected to.
closure-
Type:
GClosureThe closure the handlers will invoke.
The argument can be NULL.The data is owned by the caller of the function. func-
Type:
gpointerThe C closure callback of the handlers (useless for non-C closures).
The argument can be NULL.The data is owned by the caller of the function. data-
Type:
gpointerThe closure data of the handlers’ closures.
The argument can be NULL.The data is owned by the caller of the function.