Creates a new signal.
(This is usually done in the class initializer.)
A signal name consists of segments consisting of ASCII letters and digits, separated by either the `-` or `_` character. The first character of a signal name must be a letter. Names which violate these rules lead to undefined behaviour. These are the same rules as for property naming (see ParamSpec.internal).
When registering a signal and looking up a signal, either separator can be used, but they cannot be mixed. Using `-` is considerably more efficient. Using `_` is discouraged.
If 0 is used for class_offset
subclasses cannot override the class handler in their class_init method by doing super_class-
>signal_handler = my_signal_handler. Instead they will have to use
override_class_handler.
If c_marshaller
is null, g_cclosure_marshal_generic
will be used as the
marshaller for this signal. In some simple cases, @new will use a more optimized c_marshaller and
va_marshaller for the signal instead of g_cclosure_marshal_generic
.
If c_marshaller
is non-null, you need to also specify a va_marshaller using
g_signal_set_va_marshaller
or the generic va_marshaller will be used.
signal_name |
the name for the signal |
itype |
the type this signal pertains to. It will also pertain to types which are derived from this type. |
signal_flags |
a combination of SignalFlags 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_offset |
The offset of the function pointer in the class structure for this type. Used to invoke a class method generically. Pass 0 to not associate a class method slot with this signal. |
accumulator |
the accumulator for this signal; may be null. |
c_marshaller |
the function to translate arrays of parameter values to signal emissions into C language callback invocations or null. |
return_type |
the type of return value, or g_type_none for a signal without a return value. |
n_params |
the number of parameter types to follow. |
... |
a list of types, one for each parameter. |
accu_data |
user data for the |
the signal id |