Function

PurplePrefCallback

Declaration

void
(* PurplePrefCallback) (
  const char* name,
  PurplePrefType type,
  gconstpointer val,
  gpointer data
)

Description [src]

The type of callbacks for preference changes.

See purple_prefs_connect_callback().

Parameters

name const char*
 

The name of the preference which has changed.

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

The type of the preferenced named name.

val gconstpointer
 

The new value of the preferencs; should be cast to the correct type. For instance, to recover the value of a #PURPLE_PREF_INT preference, use GPOINTER_TO_INT(val). Alternatively, just call purple_prefs_get_int(), purple_prefs_get_string_list() etc.

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

Arbitrary data specified when the callback was connected with purple_prefs_connect_callback().

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