System plików

openfiledialog

Otwiera natywny selektor plików i zwraca metadane wybranego pliku.

Składnia

openfiledialog(options?: DialogOptions): FileSystemItem | nil

Argumenty

NazwaTypOpis
options?DialogOptionsOpcjonalna tabela ustawień, która kontroluje zachowanie operacji.

Zwroty

NazwaTypOpis
fileFileSystemItem | nilWybrane metadane pliku lub zero, gdy okno dialogowe zostanie anulowane.

Opis

Otwiera natywny selektor plików i zwraca metadane wybranego pliku.

Wywolaj z 1 parametrami: options. Tabela argumentow wyjasnia wartosci wymagane i te, ktore doprecyzowuja zachowanie.

Zwraca file (FileSystemItem | nil). Uzyj tabeli zwrotow, aby oddzielic wartosci sukcesu, wyniki nil i bledy do obsluzenia.

Przykład

Otwórz selektor plików z filtrem tytułu i rozszerzenia.

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

if file then
    print(file)
end

Typy

DialogOptions

Konfiguruje natywne okno dialogowe wyboru pliku lub folderu.

title? string Ustawia tytuł okna dialogowego.defaultPath? string Wybiera katalog wyświetlany po otwarciu okna dialogowego.extensionFilter? {string} Ogranicza wybrane pliki do wymienionych rozszerzeń, z kropką wiodącą lub bez niej.suggestedName? string Podaje początkową nazwę pliku w oknach dialogowych zapisywania.defaultExtension? string Ustawia rozszerzenie używane, gdy wprowadzona nazwa pliku nie ma żadnego.