Method

XdpPortalsave_files

Declaration [src] 

void
xdp_portal_save_files (
  XdpPortal* portal,
  XdpParent* parent,
  const char* title,
  const char* current_name,
  const char* current_folder,
  GVariant* files,
  GVariant* choices,
  XdpSaveFileFlags flags,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Asks for a folder as a location to save one or more files.

The names of the files will be used as-is and appended to the selected folder’s path in the list of returned files. If the selected folder already contains a file with one of the given names, the portal may prompt or take some other action to construct a unique file name and return that instead.

The format for the choices argument is the same as for xdp_portal_open_file().

When the request is done, callback will be called. You can then call xdp_portal_save_file_finish() to get the results.

This method completes asynchronously. Use xdp_portal_save_files_finish() inside the GAsyncReadyCallback to obtain the result of the operation.

Parameters

parent

Type: XdpParent

Parent window information.

The argument can be NULL.
The data is owned by the caller of the method.
title

Type: const char*

Title for the file chooser dialog.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
current_name

Type: const char*

Suggested filename.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
current_folder

Type: const char*

Suggested folder to save the file in.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
files

Type: GVariant

An array of file names to be saved.

The data is owned by the caller of the method.
choices

Type: GVariant

A GVariant describing extra widgets.

The argument can be NULL.
The data is owned by the caller of the method.
flags

Type: XdpSaveFileFlags

Options for this call.

cancellable

Type: GCancellable

Optional GCancellable.

The argument can be NULL.
The data is owned by the caller of the method.
callback

Type: GAsyncReadyCallback

A callback to call when the request is done.

The argument can be NULL.
data

Type: gpointer

Data to pass to callback.

The argument can be NULL.
The data is owned by the caller of the method.