Documentación de Real

Sistema de archivos

openfiledialog

Abre un selector de archivos nativo y devuelve los metadatos del archivo seleccionado.

Sintaxis

openfiledialog(options?: DialogOptions): FileSystemItem | nil

Argumentos

NombreTipoDescripción
options?DialogOptionsTabla de configuración opcional que controla cómo se comporta la operación.

Retornos

NombreTipoDescripción
fileFileSystemItem | nilMetadatos del archivo seleccionado, o nulo cuando se cancela el diálogo.

Descripción

Abre un selector de archivos nativo y devuelve los metadatos del archivo seleccionado.

Llamalo con 1 parametro(s): options. La tabla de argumentos explica que valores son obligatorios y cuales refinan el comportamiento.

Devuelve file (FileSystemItem | nil). Usa la tabla de retornos para separar valores correctos, resultados nil y errores recuperables.

Ejemplo

Abra un selector de archivos con un filtro de título y extensión.

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

if file then
    print(file)
end

Tipos

DialogOptions

Configura el cuadro de diálogo de selección de archivos o carpetas nativos.

title? string Establece el título de la ventana de diálogo.defaultPath? string Selecciona el directorio que se muestra cuando se abre el cuadro de diálogo.extensionFilter? {string} Limita los archivos seleccionables a las extensiones enumeradas, con o sin un punto inicial.suggestedName? string Proporciona el nombre del archivo inicial en los cuadros de diálogo para guardar.defaultExtension? string Establece la extensión utilizada cuando el nombre de archivo ingresado no tiene ninguno.