Xdp.Portal.save_file

### Method

# Xdp Portalsave_file

#### Declaration [src]

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

#### Description [src]

Asks the user for a location to save a file.

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

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

`current_file`

  Type: `const char*`

  The current file (when saving an existing file).

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

`filters`

  Type: `GVariant`

  A `GVariant` describing file filters.

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

`current_filter`

  Type: `GVariant`

  A `GVariant` describing the current file filter.

  The argument can be `NULL`.
  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.