文件系统

openfiledialog

打开本机文件选择器并返回所选文件元数据。

语法

openfiledialog(options?: DialogOptions): FileSystemItem | nil

参数

名称类型描述
options?DialogOptions控制操作行为方式的可选设置表。

返回值

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

说明

打开本机文件选择器并返回所选文件元数据。

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

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

示例

打开带有标题和扩展名过滤器的文件选择器。

local file = openfiledialog({
    title = "Choose a configuration",
    defaultPath = "workspace",
    extensionFilter = { "json", "txt" },
})

if file then
    print(file)
end

类型

DialogOptions

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

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