Method

PurpleRequestFieldListselect_item

unstable since: 3.0

Declaration [src]

gboolean
purple_request_field_list_select_item (
  PurpleRequestFieldList* field,
  const char* id
)

Description [src]

Selects the item with the given id if found.

If the item is already selected, this does nothing.

If the list does not allow multiple selections and the item is not found, then the current selection will be cleared.

Available since: 3.0

Parameters

id

Type: const char*

The id of the item to select.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.

Return value

Type: gboolean

True if the item was newly selected.