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