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.

Parameters

parent XdpParent
 

Parent window information.

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

Title for the file chooser dialog.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
current_name const char*
 

Suggested filename.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
current_folder const char*
 

Suggested folder to save the file in.

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

An array of file names to be saved.

 The data is owned by the caller of the function.
choices GVariant*
 

A GVariant describing extra widgets.

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

Options for this call.

cancellable GCancellable*
 

Optional GCancellable

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

A callback to call when the request is done.

data gpointer
 

Data to pass to callback.