GObject.signal_connect_data
Description: Reference for GObject.signal_connect_data

### 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: `GObject`

  The 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: `GCallback`

  The `GCallback` to connect.

`data`

  Type: `gpointer`

  Data to pass to `c_handler` calls.

  The argument can be `NULL`.
  The data is owned by the caller of the function.

`destroy_data`

  Type: `GClosureNotify`

  A `GClosureNotify` for `data`.

  The argument can be `NULL`.

`connect_flags`

  Type: `GConnectFlags`

  A combination of `GConnectFlags`.

#### Return value

Type: `gulong`

The handler ID (always greater than 0).