filesave

`filesave()` creates a save-file dialog object. Use it when an Expr script needs the user to choose a destination path.

Creates a save-file dialog.

dlg = filesave();

All configuration methods return the dialog object so calls can be chained.

Sets the dialog title.

dlg = filesave().title("Save image");

Sets the initial directory. The path is resolved through host profile path rules.

dlg = filesave().directory("images");

Sets the initial file name.

dlg = filesave().file("output.png");

Adds a file filter.

Arguments:

dlg = filesave()
    .add_filter("PNG image", "*.png")
    .add_filter("All files", "*.*");

This method exists because `fileopen()` and `filesave()` share the same dialog object implementation, but save dialogs ignore multi-select.

dlg = filesave().multi_select(true);    // ignored by save dialog

Sets a callback for asynchronous result handling. The callback receives one argument: an `array` containing selected file paths. For save dialogs, the array normally contains one path.

When `on_result()` is used, `show()` displays the dialog and returns the dialog object immediately.

function save_selected(files)
{
    if (!files.empty())
    {
        print("Save to: ", files.get(0));
    }
}
 
filesave()
    .title("Save result")
    .file("result.png")
    .on_result(save_selected)
    .show();

Shows the dialog.

Without `on_result()`, `show()` blocks until the dialog is closed and returns an `array` of selected paths. If the user cancels, it returns `none()`.

files = filesave()
    .title("Save image")
    .file("result.png")
    .add_filter("PNG image", "*.png")
    .show();
 
if (!files.is_none())
{
    print("Save to: ", files.get(0));
}

Previous: fileopen

Next: msgok