Function

Purplerequest_action_varg

Declaration [src]

void*
purple_request_action_varg (
  void* handle,
  const char* title,
  const char* primary,
  const char* secondary,
  int default_action,
  PurpleRequestCommonParameters* cpar,
  void* user_data,
  size_t action_count,
  va_list actions
)

Description [src]

va_list version of purple_request_action(); see its documentation.

This function is not directly available to language bindings

Parameters

handle void*
 

The plugin or connection handle. For some things this is extremely important. See the comments on purple_request_input().

 The argument can be NULL.
 The data is owned by the caller of the function.
title const char*
 

The title of the message, or NULL if it should have no title.

 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, or NULL if you’re feeling enigmatic.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
secondary const char*
 

Secondary information, or NULL if there is none.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
default_action int
 

The default action, zero-indexed; if the third action supplied should be the default, supply 2. This should be the action that users are most likely to select.

cpar PurpleRequestCommonParameters
 

The PurpleRequestCommonParameters object, which gets unref’ed after this call.

 The data is owned by the caller of the function.
user_data void*
 

The data to pass to the callback.

 The argument can be NULL.
 The data is owned by the caller of the function.
action_count size_t
 

The number of actions.

actions va_list
 

A list of actions. These are pairs of arguments. The first of each pair is the char * label that appears on the button. It should have an underscore before the letter you want to use as the accelerator key for the button. The second of each pair is the PurpleRequestActionCb function to use when the button is clicked.

Return value

Returns: void*
  No description available.
 The data is owned by the called function.
 The return value can be NULL.