Documentação Real

Sintaxe

savefiledialog(content: string, options?: DialogOptions): FileSystemItem | nil

Argumentos

Nome	Tipo	Descrição
`content`	`string`	Texto ou string de bytes a serem gravados.
`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 uma caixa de diálogo nativa para salvar e grava o conteúdo fornecido quando o usuário escolhe um caminho.

Chame com 2 parametro(s): content, 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

Deixe o usuário escolher onde salvar o conteúdo gerado.

local saved = savefiledialog("Example output", {
    title = "Save output",
    suggestedName = "output.txt",
    defaultExtension = "txt",
})

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