Luna::Window::save_file_dialog

R< Path > save_file_dialog(const c8 *title=nullptr, Span< const FileDialogFilter > filters={}, const Path &initial_file_path=Path(), FileDialogFlag flags=FileDialogFlag::none)

Displays one save file dialog and fetches the selecting results.

Parameters

  • in title

    The title of the dialog, encoded in UTF-8. If this is nullptr, the platform-specific default title will be used.

  • in filters

    The filters used by the open file dialog. If this is empty, the user can select any file types.

  • in initial_file_path

    The initial directory and file name to set the file dialog to. If this is empty, the system decides the default directory and leaves file name empty. This path must be a platform native path if specified.

  • in flags

    The additional flags.

Return value

Returns the user-specified file path. The path is platform native, absolute path.

Valid Usage

  • If title is not nullptr, title must specify one null-terminated string.