connect_data

Description:

public static ulong connect_data (void* instance, string detailed_signal, Callback handler, void* data, ClosureNotify destroy_data, ConnectFlags flags)

Connects a ObjectConstructorFunc function to a signal for a particular object.

Similar to connect, but allows to provide a ClosureNotify for the data which will be called when the signal handler is disconnected and no longer used. Specify connect_flags if you need `..._after()` or `..._swapped()` variants of this function.

This function cannot fail. If the given signal name doesn’t exist, a critical warning is emitted. No validation is performed on the ‘detail’ string when specified in detailed_signal, other than a non-empty check.

Refer to the [signals documentation](signals.html) for more details.

Parameters:

instance	the instance to connect to.
detailed_signal	a string of the form "signal-name:`:detail`".
data	data to pass to `c_handler` calls.
destroy_data	a ClosureNotify for `data`.
c_handler	the ObjectConstructorFunc to connect.
connect_flags	a combination of ConnectFlags.

Returns:

the handler ID (always greater than 0)