Real 文档

语法

openfilesdialog(options?: DialogOptions): table | nil

参数

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

返回值

名称	类型	描述
`files`	`table \| nil`	所选文件元数据的数组表，取消时为 nil。

说明

打开可以返回多个选定文件的本机文件选择器。

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

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

示例

让用户使用扩展名过滤器选择多个文件。

local files = openfilesdialog({
    title = "Choose source files",
    defaultPath = "workspace",
    extensionFilter = { "lua", "luau", "txt" },
})

if files then
    for _, file in ipairs(files) do
        print(file)
    end
end

类型

DialogOptions

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

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