Function
GObjectsignal_connect_data
Declaration [src]
gulong
g_signal_connect_data (
GObject* instance,
const gchar* detailed_signal,
GCallback c_handler,
gpointer data,
GClosureNotify destroy_data,
GConnectFlags connect_flags
)
Description [src]
Connects a GCallback function to a signal for a particular object. Similar
to g_signal_connect(), but allows to provide a GClosureNotify 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 for more details.
This function is not directly available to language bindings.
Parameters
instance-
Type:
GObjectThe instance to connect to.
The data is owned by the caller of the function. detailed_signal-
Type:
const gchar*A string of the form “signal-name::detail”.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. c_handler-
Type:
GCallbackThe
GCallbackto connect. data-
Type:
gpointerData to pass to
c_handlercalls.The argument can be NULL.The data is owned by the caller of the function. destroy_data-
Type:
GClosureNotifyA
GClosureNotifyfordata.The argument can be NULL. connect_flags-
Type:
GConnectFlagsA combination of
GConnectFlags.