Real Dokumentation

Syntax

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

Argumente

Name	Typ	Beschreibung
`content`	`string`	Zu schreibender Text oder Byte-String.
`options?`	`DialogOptions`	Optionale Einstellungstabelle, die das Verhalten des Vorgangs steuert.

Rückgaben

Name	Typ	Beschreibung
`file`	`FileSystemItem \| nil`	Ausgewählte Dateimetadaten oder Null, wenn der Dialog abgebrochen wird.

Beschreibung

Öffnet einen nativen Speicherdialog und schreibt den bereitgestellten Inhalt, wenn der Benutzer einen Pfad auswählt.

Rufe es mit 2 Parameter(n) auf: content, options. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.

Es gibt file (FileSystemItem | nil) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.

Beispiel

Lassen Sie den Benutzer entscheiden, wo generierte Inhalte gespeichert werden sollen.

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

if saved then
    print(saved)
end

Typen

DialogOptions

Konfiguriert den nativen Datei- oder Ordnerauswahldialog.

title? string Legt den Titel des Dialogfensters fest.defaultPath? string Wählt das Verzeichnis aus, das beim Öffnen des Dialogs angezeigt wird.extensionFilter? {string} Beschränkt auswählbare Dateien auf die aufgelisteten Erweiterungen, mit oder ohne führenden Punkt.suggestedName? string Gibt den anfänglichen Dateinamen in Speicherdialogen an.defaultExtension? string Legt die Erweiterung fest, die verwendet wird, wenn der eingegebene Dateiname keine hat.