ファイルシステム

openfolderdialog

ネイティブ フォルダー ピッカーを開き、選択されたフォルダーのメタデータを返します。

構文

openfolderdialog(options?: DialogOptions): FileSystemItem | nil

引数

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

戻り値

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