Documentação Real

Sintaxe

openfilesdialog(options?: DialogOptions): table | nil

Argumentos

Nome	Tipo	Descrição
`options?`	`DialogOptions`	Tabela de configurações opcionais que controla como a operação se comporta.

Retornos

Nome	Tipo	Descrição
`files`	`table \| nil`	Tabela de matriz de metadados do arquivo selecionado ou nula quando cancelada.

Descrição

Abre um seletor de arquivos nativo que pode retornar vários arquivos selecionados.

Chame com 1 parametro(s): options. A tabela de argumentos explica quais valores sao obrigatorios e quais refinam o comportamento.

Retorna files (table | nil). Use a tabela de retornos para separar valores bem sucedidos, nil e erros recuperaveis.

Exemplo

Deixe o usuário selecionar vários arquivos com um filtro de extensão.

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

Tipos

DialogOptions

Configura a caixa de diálogo de seleção de arquivo ou pasta nativa.

title? string Define o título da janela de diálogo.defaultPath? string Seleciona o diretório mostrado quando a caixa de diálogo é aberta.extensionFilter? {string} Limita os arquivos selecionáveis às extensões listadas, com ou sem um ponto inicial.suggestedName? string Fornece o nome inicial do arquivo nas caixas de diálogo para salvar.defaultExtension? string Define a extensão usada quando o nome do arquivo inserido não possui nenhuma.