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.

Parameters

instance GObject
 

The instance to connect to.

 The data is owned by the caller of the function.
detailed_signal const gchar*
 

A string of the form “signal-name::detail”.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
c_handler GCallback
 

The GCallback to connect.

data gpointer
 

Data to pass to c_handler calls.

destroy_data GClosureNotify
 

A GClosureNotify for data.

connect_flags GConnectFlags
 

A combination of GConnectFlags.

Return value

Returns: gulong
 

The handler ID (always greater than 0 for successful connections)