[ Version ( since = "4.2" ) ]
public ulong connect_raw (void* instance, string sig_name, bool private_thread, bool private_job, ThreadWrapperCallback callback)

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

The difference with connect and similar functions are:

  • the callback argument is not a ObjectConstructorFunc function, so the callback signature is not dependent on the signal itself
  • the signal handler must not have to return any value
  • the callback function will be called asynchronously, the caller may need to use iterate to get the notification
  • if private_job and private_thread control in which case the signal is propagated.

Also note that signal handling is done asynchronously: when emitted in the worker thread, it will be "queued" to be processed in the user thread when it has the chance (when iterate is called directly or indirectly). The side effect is that the callback function is usually called long after the object emitting the signal has finished emitting it.

To disconnect a signal handler, don't use any of the g_signal_handler_*() functions but the disconnect method.



a ThreadWrapper object


the instance to connect to


a string of the form "signal-name::detail"


set to true if callback is to be invoked only if the signal has been emitted while in this's private sub thread (ie. used when this is executing some functions specified by execute or execute_void), and to false if the callback is to be invoked whenever the signal is emitted, independently of the thread in which the signal is emitted.


set to true if callback is to be invoked only if the signal has been emitted when a job created for the calling thread is being executed, and to false if callback has to be called whenever the sig_name signal is emitted by instance. Note that this argument is not taken into account if private_thread is set to false .


a ThreadWrapperCallback function


data to pass to callback's calls


the handler ID