Function

Purplenotify_searchresults

Declaration [src]

void*
purple_notify_searchresults (
  PurpleConnection* gc,
  const char* title,
  const char* primary,
  const char* secondary,
  PurpleNotifySearchResults* results,
  PurpleNotifyCloseCallback cb,
  gpointer user_data
)

Description [src]

Displays results from a buddy search. This can be, for example, a window with a list of all found buddies, where you are given the option of adding buddies to your buddy list.

Parameters

`gc`	`PurpleConnection`
	The PurpleConnection handle associated with the information.
	The data is owned by the caller of the function.
`title`	`const char*`
	The title of the message. If this is NULL, the title will be “Search Results.”
	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.
`results`	`PurpleNotifySearchResults`
	The PurpleNotifySearchResults instance.
	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 close callback and any other callback associated with a button.
	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`.