Documentación de Real

Sistema de archivos

openfolderdialog

Abre un selector de carpetas nativo y devuelve los metadatos de la carpeta seleccionada.

Sintaxis

openfolderdialog(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
folderFileSystemItem | nilMetadatos de la carpeta seleccionada, o nulos cuando se cancela.

Descripción

Abre un selector de carpetas nativo y devuelve los metadatos de la carpeta seleccionada.

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

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

Ejemplo

Permita que el usuario seleccione una carpeta desde un cuadro de diálogo nativo.

local folder = openfolderdialog({
    title = "Choose a workspace folder",
    defaultPath = "workspace",
})

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