Documentação Real

Sintaxe

openfiledialog(options?: DialogOptions): FileSystemItem | 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
`file`	`FileSystemItem \| nil`	Metadados do arquivo selecionado ou nulos quando a caixa de diálogo é cancelada.

Descrição

Abre um seletor de arquivos nativo e retorna os metadados do arquivo selecionado.

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

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

Exemplo

Abra um seletor de arquivos com um filtro de título e extensão.

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

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