ファイルシステム

savefiledialog

ネイティブの保存ダイアログを開き、ユーザーがパスを選択すると、提供されたコンテンツを書き込みます。

構文

savefiledialog(content: string, options?: DialogOptions): FileSystemItem | nil

引数

名前説明
contentstring書き込むテキストまたはバイト文字列。
options?DialogOptions操作の動作を制御するオプションの設定テーブル。

戻り値

名前説明
fileFileSystemItem | nil選択されたファイルのメタデータ、またはダイアログがキャンセルされた場合は nil。

説明

ネイティブの保存ダイアログを開き、ユーザーがパスを選択すると、提供されたコンテンツを書き込みます。

2 個のパラメータで呼び出します: content, options。引数表では必須値と動作を調整する値を確認できます。

file (FileSystemItem | nil) を返します。戻り値表を使って成功値、nil 結果、回復可能なエラーを分けて扱ってください。

生成されたコンテンツを保存する場所をユーザーが選択できるようにします。

local saved = savefiledialog("Example output", {
    title = "Save output",
    suggestedName = "output.txt",
    defaultExtension = "txt",
})

if saved then
    print(saved)
end

DialogOptions

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

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