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 入力したファイル名に拡張子がない場合に使用する拡張子を設定します。