Function

Purplenotify_formatted

since: 2.0

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.

Available since: 2.0

Parameters

handle

Type: void*

The plugin or connection handle.

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

Type: 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

Type: 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

Type: 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

Type: 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

Type: PurpleNotifyCloseCallback

The callback to call when the user closes the notification.

user_data

Type: 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

Type: void*

A UI-specific handle.

The data is owned by the called function.
The return value can be NULL.