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

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

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

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

Type: gboolean

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

ok_cb

Type: GCallback

The callback for the OK button.

cancel_cb

Type: GCallback

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

cpar

Type: PurpleRequestCommonParameters

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

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

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

Type: void*

A UI-specific handle.

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