Constructor

PurpleRequestFieldChoicenew

Declaration [src]

PurpleRequestField*
purple_request_field_choice_new (
  const char* id,
  const char* text,
  gpointer default_value
)

Description [src]

Creates a multiple choice field.

This is often represented as a group of radio buttons.

Parameters

id

Type: const char*

The field ID.

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

Type: const char*

The optional label of the field.

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

Type: gpointer

The default choice.

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

Return value

Type: PurpleRequestField

The new field.

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