Function

Purplenotify_message

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.

Parameters

handle void*
 

The plugin or connection handle.

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

The notification type.

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

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

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