openfilesdialog - Real Function Reference

openfilesdialog(options?: DialogOptions): { FileSystemItem } | nil

引数

DialogOptions

Optional table. openfilesdialog では title、defaultPath、extensionFilter が使用されます。extensionFilter は extension strings の table です。各 filter が *.<extension> になる前に、先頭の . または *. は取り除かれます。

戻り値

{ FileSystemItem } | nil

選択されたファイルの file item 値の Array table、または dialog がキャンセルされた場合や selected filesystem paths が返されない場合は nil。Dialog failures は Failed to open file dialog を throw します。

型

DialogOptions

ネイティブファイルまたはフォルダーの選択ダイアログを構成します。

Name	Type	Required	説明
`title`	`string`	No	ダイアログウィンドウのタイトルを設定します。
`defaultPath`	`string`	No	ダイアログが開いたときに表示されるディレクトリを選択します。
`extensionFilter`	`{string}`	No	先頭のドットの有無にかかわらず、選択可能なファイルをリストされた拡張子に制限します。
`suggestedName`	`string`	No	保存ダイアログに初期ファイル名を指定します。
`defaultExtension`	`string`	No	入力したファイル名に拡張子がない場合に使用する拡張子を設定します。

例

file picker を開いて 1 つ以上のファイルを選択し、それぞれの selected file item を処理します。

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

if files then
    for _, file in ipairs(files) do
        print(file:GetName())
        print(file:IsFile())
    end
else
    print("No files selected")
end

​引数

​戻り値

​型

​DialogOptions

​例

引数

戻り値

型

DialogOptions

例