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`.