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

openfilesdialog

Открывает встроенное средство выбора файлов, которое может возвращать несколько выбранных файлов.

Синтаксис

openfilesdialog(options?: DialogOptions): table | nil

Аргументы

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

Возвраты

ИмяТипОписание
filestable | nilТаблица массива метаданных выбранного файла или ноль при отмене.

Описание

Открывает встроенное средство выбора файлов, которое может возвращать несколько выбранных файлов.

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

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

Пример

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

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

Типы

DialogOptions

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

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