Real ドキュメント

構文

openfiledialog(options?: DialogOptions): FileSystemItem | nil

引数

名前	型	説明
`options?`	`DialogOptions`	操作の動作を制御するオプションの設定テーブル。

戻り値

名前	型	説明
`file`	`FileSystemItem \| nil`	選択されたファイルのメタデータ、またはダイアログがキャンセルされた場合は 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 入力したファイル名に拡張子がない場合に使用する拡張子を設定します。