Function

Purplenotify_searchresults

since: 2.0

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.

Available since: 2.0

Parameters

gc

Type: PurpleConnection

The PurpleConnection handle associated with the information.

The data is owned by the caller of the function.
title

Type: 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

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

Type: PurpleNotifySearchResults

The PurpleNotifySearchResults instance.

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

Type: void*

A UI-specific handle.

The data is owned by the called function.
The return value can be NULL.