Function

Purplesignal_connect_priority

since: 2.0

Declaration [src]

gulong
purple_signal_connect_priority (
  void* instance,
  const char* signal,
  void* handle,
  GCallback func,
  void* data,
  int priority
)

Description [src]

Connects a signal handler to a signal for a particular object.

Take care not to register a handler function twice. Purple will not correct any mistakes for you in this area.

See purple_signal_disconnect()

Available since: 2.0

Parameters

instance

Type: void*

The instance to connect to.

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

Type: const char*

The name of the signal to connect.

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

Type: void*

The handle of the receiver.

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

Type: GCallback

The callback function.

data

Type: void*

The data to pass to the callback function.

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

Type: int

The priority with which the handler should be called. Signal handlers are called in ascending numerical order of priority from #PURPLE_SIGNAL_PRIORITY_LOWEST to #PURPLE_SIGNAL_PRIORITY_HIGHEST.

Return value

Type: gulong

The signal handler ID.