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