语法：

get_save_filename(filter, fname);

返回: String（字符串）。

描述

此函数打开一个对话框，并要求玩家提供要使用给定过滤器保存的文件名。过滤器的格式为 “name1|mask1|name2|mask2|...”，其中掩码可能包含不同的选项，它们之间带有分隔符，你也可以使用 “*” 表示任意字符串。例如：“bitmaps|*.bmp;*.wmf” 会要求用户从系统中选择位图文件的名称，但只能选择那些具有两个指定扩展名的文件（bmp 和 png）。此函数 不 保存文件本身！它只返回一个包含文件全名和路径的字符串。如果用户按下 “取消”，则返回空字符串 ""。

使用此函数时需要注意的一点是，在游戏持续时间内，它会授予你对该文件的某些权限。因此，一旦你从用户那里获得文件路径，你就可以一次又一次地访问它而无需询问，并且该权限同时适用于读取 和 写入。

NOTE: This function is only valid on the Windows and macOS targets.

例如：

var file;
file = get_save_filename("screenshot|*.png", "");
if file != ""
   {
   screen_save(file);
   }

上面的代码将要求用户选择要保存的图像文件名文件，然后检查返回的文件名和路径，如果它不是空字符串，则需要屏幕截图并使用给定名称保存。