Function

Purplesignal_connect_priority

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()

Parameters

instance void*
 

The instance to connect to.

 The argument can be NULL.
 The data is owned by the caller of the function.
signal 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 void*
 

The handle of the receiver.

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

The callback function.

data 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 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

Returns: gulong
 

The signal handler ID.