文件系统

savefiledialog

当用户选择路径时,打开本机保存对话框并写入提供的内容。

语法

savefiledialog(content: string, options?: DialogOptions): FileSystemItem | nil

参数

名称类型描述
contentstring要写入的文本或字节字符串。
options?DialogOptions控制操作行为方式的可选设置表。

返回值

名称类型描述
fileFileSystemItem | nil选定的文件元数据,或取消对话框时为零。

说明

当用户选择路径时,打开本机保存对话框并写入提供的内容。

使用 2 个参数调用: content, options。参数表会说明哪些值必填,哪些值只用于细化行为。

返回 file (FileSystemItem | nil)。使用返回表区分成功值、nil 结果和可恢复错误。

示例

让用户选择保存生成内容的位置。

local saved = savefiledialog("Example output", {
    title = "Save output",
    suggestedName = "output.txt",
    defaultExtension = "txt",
})

if saved then
    print(saved)
end

类型

DialogOptions

配置本机文件或文件夹选择对话框。

title? string 设置对话框窗口标题。defaultPath? string 选择对话框打开时显示的目录。extensionFilter? {string} 将可选文件限制为列出的扩展名,带或不带前导点。suggestedName? string 在保存对话框中提供初始文件名。defaultExtension? string 设置当输入的文件名没有扩展名时使用的扩展名。