Function

Purplerequest_choice_varg

Declaration [src]

void*
purple_request_choice_varg (
  void* handle,
  const char* title,
  const char* primary,
  const char* secondary,
  gpointer default_value,
  const char* ok_text,
  GCallback ok_cb,
  const char* cancel_text,
  GCallback cancel_cb,
  PurpleRequestCommonParameters* cpar,
  void* user_data,
  va_list choices
)

Description [src]

va_list version of purple_request_choice(); 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_value gpointer
 

The default choice; this should be one of the values listed in the varargs.

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

The text for the OK button, which may not be NULL.

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

The callback for the OK button, which may not be NULL.

cancel_text const char*
 

The text for the Cancel button, which may not be NULL.

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

The callback for the Cancel button, or NULL to do nothing.

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.
choices va_list
 

The choices, which should be pairs of char * descriptions and int values, terminated with a NULL parameter.

Return value

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