openfiledialog - Real Function Reference

openfiledialog(options?: DialogOptions): FileSystemItem | nil

Argumentos

DialogOptions

Optional table. Para openfiledialog, title, defaultPath e extensionFilter sao usados. extensionFilter e uma table de extension strings; . ou *. inicial e removido antes de cada filter virar *.<extension>.

Retornos

FileSystemItem | nil

Selected file item, ou nil quando o dialog e cancelado ou nenhum selected filesystem path e retornado. Dialog failures lancam Failed to open file dialog.

Tipos

DialogOptions

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

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

Exemplo

Abra um file picker e trate o selected file item ou cancellation.

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

if file then
    print(file:GetName())
    print(file:IsFile())
else
    print("No file selected")
end

​Argumentos

​Retornos

​Tipos

​DialogOptions

​Exemplo

Argumentos

Retornos

Tipos

DialogOptions

Exemplo