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

Type: 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

Type: PurplePrefType

The type of the preferenced named name.

val

Type: 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

Type: 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.