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.