Real Dokumentation

Syntax

openfilesdialog(options?: DialogOptions): table | nil

Argumente

Name	Typ	Beschreibung
`options?`	`DialogOptions`	Optionale Einstellungstabelle, die das Verhalten des Vorgangs steuert.

Rückgaben

Name	Typ	Beschreibung
`files`	`table \| nil`	Array-Tabelle der ausgewählten Dateimetadaten oder Null, wenn der Vorgang abgebrochen wird.

Beschreibung

Öffnet eine native Dateiauswahl, die mehrere ausgewählte Dateien zurückgeben kann.

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

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

Beispiel

Lassen Sie den Benutzer mehrere Dateien mit einem Erweiterungsfilter auswählen.

local files = openfilesdialog({
    title = "Choose source files",
    defaultPath = "workspace",
    extensionFilter = { "lua", "luau", "txt" },
})

if files then
    for _, file in ipairs(files) do
        print(file)
    end
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.