Function

Pidginprefs_dropdown

Declaration [src]

GtkWidget*
pidgin_prefs_dropdown (
  GtkWidget* page,
  const gchar* title,
  PurplePrefType type,
  const char* key,
  ...
)

Description [src]

Add a new dropdown representing a preference of the specified type.

This function is not directly available to language bindings

Parameters

page GtkWidget
 

The page to which the dropdown will be added.

 The data is owned by the caller of the function.
title const gchar*
 

The text to be displayed as the dropdown label.

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

The type of preference to be stored in the generated dropdown.

key const char*
 

The key of the pref that will be represented by the dropdown.

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

The choices to be added to the dropdown, choices should be paired as label/value.

Return value

Returns: GtkWidget
 

The new dropdown.

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