Function

GObjectsignal_new_class_handler

Declaration

guint
g_signal_new_class_handler (
  const gchar* signal_name,
  GType itype,
  GSignalFlags signal_flags,
  GCallback class_handler,
  GSignalAccumulator accumulator,
  gpointer accu_data,
  GSignalCMarshaller c_marshaller,
  GType return_type,
  guint n_params,
  ...
)

Description

Creates a new signal. (This is usually done in the class initializer.)

This is a variant of g_signal_new() that takes a C callback instead of a class offset for the signal’s class handler. This function doesn’t need a function pointer exposed in the class structure of an object definition, instead the function pointer is passed directly and can be overridden by derived classes with g_signal_override_class_closure() or g_signal_override_class_handler()and chained to with g_signal_chain_from_overridden() or g_signal_chain_from_overridden_handler().

See g_signal_new() for information about signal names.

If c_marshaller is NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal.

Available since:

2.18

Parameters

`signal_name`	`const gchar*`
	The name for the signal.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`itype`	`GType`
	The type this signal pertains to. It will also pertain to types which are derived from this type.
`signal_flags`	`GSignalFlags`
	A combination of `GSignalFlags` specifying detail of when the default handler is to be invoked. You should at least specify `G_SIGNAL_RUN_FIRST` or `G_SIGNAL_RUN_LAST`.
`class_handler`	`GCallback`
	A `GCallback` which acts as class implementation of this signal. Used to invoke a class method generically. Pass `NULL` to not associate a class method with this signal.
	The argument can be `NULL`.
`accumulator`	`GSignalAccumulator`
	The accumulator for this signal; may be `NULL`.
	The argument can be `NULL`.
`accu_data`	`gpointer`
	User data for the `accumulator`.
	The argument can be `NULL`.
`c_marshaller`	`GSignalCMarshaller`
	The function to translate arrays of parameter values to signal emissions into C language callback invocations or `NULL`.
	The argument can be `NULL`.
`return_type`	`GType`
	The type of return value, or #G_TYPE_NONE for a signal without a return value.
`n_params`	`guint`
	The number of parameter types to follow.
`...`
	A list of types, one for each parameter.

Return value

Returns:	`guint`
	The signal id.