Method

PurpleNotifyUserInfoadd_pair_html

since: 3.0

Declaration [src]

void
purple_notify_user_info_add_pair_html (
  PurpleNotifyUserInfo* user_info,
  const char* label,
  const char* value
)

Description [src]

Add a label/value pair to a PurpleNotifyUserInfo object. PurpleNotifyUserInfo keeps track of the order in which pairs are added.

Available since: 3.0

Parameters

label

Type: const char*

A label, which for example might be displayed by a UI with a colon after it (“Status:”). Do not include a colon. If NULL, value will be displayed without a label.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

value

Type: const char*

The value, which might be displayed by a UI after the label. This should be valid HTML. If you want to insert plaintext then use purple_notify_user_info_add_pair_plaintext(), instead. If this is NULL the label will still be displayed; the UI should treat label as independent and not include a colon if it would otherwise.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.