Function
GObjectsignal_accumulator_first_wins
since: 2.28
Declaration
gboolean
g_signal_accumulator_first_wins (
GSignalInvocationHint* ihint,
GValue* return_accu,
const GValue* handler_return,
gpointer dummy
)
Description
A predefined GSignalAccumulator for signals intended to be used as a
hook for application code to provide a particular value. Usually
only one such value is desired and multiple handlers for the same
signal don’t make much sense (except for the case of the default
handler defined in the class structure, in which case you will
usually want the signal connection to override the class handler).
This accumulator will use the return value from the first signal handler that is run as the return value for the signal and not run any further handlers (ie: the first handler “wins”).
Available since: 2.28
Parameters
ihint-
Type:
GSignalInvocationHintStandard
GSignalAccumulatorparameter.The data is owned by the caller of the function. return_accu-
Type:
GValueStandard
GSignalAccumulatorparameter.The data is owned by the caller of the function. handler_return-
Type:
GValueStandard
GSignalAccumulatorparameter.The data is owned by the caller of the function. dummy-
Type:
gpointerStandard
GSignalAccumulatorparameter.The argument can be NULL.The data is owned by the caller of the function.