Function

Purplenotify_message

since: 2.0

Declaration [src] 

void*
purple_notify_message (
  void* handle,
  PurpleNotifyMessageType type,
  const char* title,
  const char* primary,
  const char* secondary,
  PurpleRequestCommonParameters* cpar,
  PurpleNotifyCloseCallback cb,
  gpointer user_data
)

Description [src]

Displays a notification message to the user.

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.
type

Type: PurpleNotifyMessageType

The notification type.

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.
cpar

Type: PurpleRequestCommonParameters

The PurpleRequestCommonParameters associated with this request, or NULL if none is.

The data is owned by the caller of the function.
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.