Real Dokumentation

Syntax

openfiledialog(options?: DialogOptions): FileSystemItem | nil

Argumente

Name	Typ	Beschreibung
`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 eine native Dateiauswahl und gibt die ausgewählten Dateimetadaten zurück.

Rufe es mit 1 Parameter(n) auf: 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

Öffnen Sie eine Dateiauswahl mit einem Titel- und Erweiterungsfilter.

local file = openfiledialog({
    title = "Choose a configuration",
    defaultPath = "workspace",
    extensionFilter = { "json", "txt" },
})

if file then
    print(file)
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.