Function

Purplerequest_file

Declaration [src]

void*
purple_request_file (
  void* handle,
  const char* title,
  const char* filename,
  gboolean savedialog,
  GCallback ok_cb,
  GCallback cancel_cb,
  PurpleRequestCommonParameters* cpar,
  void* user_data
)

Description [src]

Displays a file selector request dialog. Returns the selected filename to the callback. Can be used for either opening a file or saving a file.

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.
filename const char*
 

The default filename (may be NULL)

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

True if this dialog is being used to save a file. False if it is being used to open a file.

ok_cb GCallback
 

The callback for the OK button.

cancel_cb GCallback
 

The callback for the Cancel button, which may be NULL.

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.

Return value

Returns: void*
 

A UI-specific handle.

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