Function

Purplenotify_formatted

Declaration [src]

void*
purple_notify_formatted (
  void* handle,
  const char* title,
  const char* primary,
  const char* secondary,
  const char* text,
  PurpleNotifyCloseCallback cb,
  gpointer user_data
)

Description [src]

Displays a notification with formatted text.

The text is essentially a stripped-down format of HTML, the same that IMs may send.

Parameters

`handle`	`void*`
	The plugin or connection handle.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`title`	`const char*`
	The title of the message.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`primary`	`const char*`
	The main point of the message.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`secondary`	`const char*`
	The secondary information.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`text`	`const char*`
	The formatted text.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`cb`	`PurpleNotifyCloseCallback`
	The callback to call when the user closes the notification.
`user_data`	`gpointer`
	The data to pass to the callback.
	The argument can be `NULL`.
	The data is owned by the caller of the function.

Return value

Returns:	`void*`
	A UI-specific handle.
	The data is owned by the called function.
	The return value can be `NULL`.