Real Dokumentation

Syntax

openfolderdialog(options?: DialogOptions): FileSystemItem | nil

Argumente

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

Rückgaben

Name	Typ	Beschreibung
`folder`	`FileSystemItem \| nil`	Metadaten des ausgewählten Ordners oder Null, wenn der Vorgang abgebrochen wird.

Beschreibung

Öffnet eine native Ordnerauswahl und gibt die Metadaten des ausgewählten Ordners 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 folder (FileSystemItem | nil) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.

Beispiel

Lassen Sie den Benutzer einen Ordner aus einem nativen Dialog auswählen.

local folder = openfolderdialog({
    title = "Choose a workspace folder",
    defaultPath = "workspace",
})

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