文件系统

openfolderdialog

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

语法

openfolderdialog(options?: DialogOptions): FileSystemItem | nil

参数

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

返回值

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

说明

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

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

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

示例

让用户从本机对话框中选择一个文件夹。

local folder = openfolderdialog({
    title = "Choose a workspace folder",
    defaultPath = "workspace",
})

if folder then
    print(folder)
end

类型

DialogOptions

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

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