Method

GtkFileDialogsave

unstable since: 4.10

Declaration [src]

void
gtk_file_dialog_save (
  GtkFileDialog* self,
  GtkWindow* parent,
  GFile* current_file,
  const char* current_name,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

Description [src]

This function initiates a file save operation by presenting a file chooser dialog to the user.

You should pass either current_file if you have a file to save to, or current_name, if you are creating a new file.

If you pass current_file, the file chooser will initially be opened in the parent directory of that file, otherwise, it will be in the directory GtkFileDialog:current-folder.

The callback will be called when the dialog is dismissed. It should call gtk_file_dialog_save_finish() to obtain the result.

Available since: 4.10

Parameters

parent

Type: GtkWindow

The parent GtkWindow

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

Type: GFile

The initial file.

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

Type: const char*

The initial filename to offer.

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

Type: GCancellable

A GCancellable to cancel the operation.

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

Type: GAsyncReadyCallback

A callback to call when the operation is complete.

The argument can be NULL.
user_data

Type: gpointer

Data to pass to callback.

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