Файловая система

openfiledialog

Открывает встроенное средство выбора файлов и возвращает метаданные выбранного файла.

Синтаксис

openfiledialog(options?: DialogOptions): FileSystemItem | nil

Аргументы

ИмяТипОписание
options?DialogOptionsДополнительная таблица настроек, которая управляет поведением операции.

Возвраты

ИмяТипОписание
fileFileSystemItem | nilМетаданные выбранного файла или ноль при закрытии диалогового окна.

Описание

Открывает встроенное средство выбора файлов и возвращает метаданные выбранного файла.

Вызывай с 1 параметрами: options. Таблица аргументов показывает обязательные значения и настройки поведения.

Возвращает file (FileSystemItem | nil). Используй таблицу возвращаемых значений, чтобы отличать успех, nil и обрабатываемые ошибки.

Пример

Откройте средство выбора файлов с фильтром по названию и расширению.

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

if file then
    print(file)
end

Типы

DialogOptions

Настраивает собственный диалог выбора файла или папки.

title? string Устанавливает заголовок диалогового окна.defaultPath? string Выбирает каталог, отображаемый при открытии диалогового окна.extensionFilter? {string} Ограничивает выбираемые файлы перечисленными расширениями с точкой в начале или без нее.suggestedName? string Предоставляет исходное имя файла в диалоговых окнах сохранения.defaultExtension? string Устанавливает расширение, используемое, если введенное имя файла не имеет его.