Function

PurpleAccountOptionlist_new

since: 2.0

Declaration [src]

PurpleAccountOption*
purple_account_option_list_new (
  const gchar* text,
  const gchar* pref_name,
  GList* list
)

Description [src]

Creates a new list account option.

The list passed will be owned by the account option, and the strings inside will be freed automatically.

The list is a list of PurpleKeyValuePair items. The key is the label that should be displayed to the user, and the (const char *) value is the internal ID that should be passed to purple_account_set_string() to choose that value.

Available since: 2.0

Parameters

text

Type: const gchar*

The text of the option.

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

Type: const gchar*

The account preference name for the option.

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

Type: A list of None

The key, value list.

The called function takes ownership of the data, and is responsible for freeing it.

Return value

Type: PurpleAccountOption

The account option.

The caller of the function takes ownership of the data, and is responsible for freeing it.