파일 시스템

openfiledialog

기본 파일 선택기를 열고 선택한 파일 메타데이터를 반환합니다.

문법

openfiledialog(options?: DialogOptions): FileSystemItem | nil

인수

이름타입설명
options?DialogOptions작업 작동 방식을 제어하는 선택적 설정 테이블입니다.

반환값

이름타입설명
fileFileSystemItem | nil선택한 파일 메타데이터 또는 대화 상자가 취소되면 nil입니다.

설명

기본 파일 선택기를 열고 선택한 파일 메타데이터를 반환합니다.

1개 파라미터로 호출합니다: options. 인수 표는 필수 값과 동작을 조정하는 값을 설명합니다.

file (FileSystemItem | nil)을 반환합니다. 반환 표를 사용해 성공 값, nil 결과, 복구 가능한 오류를 구분하세요.

예제

제목 및 확장자 필터가 포함된 파일 선택기를 엽니다.

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

if file then
    print(file)
end

타입

DialogOptions

기본 파일 또는 폴더 선택 대화 상자를 구성합니다.

title? string 대화 상자 창 제목을 설정합니다.defaultPath? string 대화 상자가 열릴 때 표시되는 디렉터리를 선택합니다.extensionFilter? {string} 선택 가능한 파일을 앞에 점이 있거나 없이 나열된 확장자로 제한합니다.suggestedName? string 저장 대화 상자에 초기 파일 이름을 제공합니다.defaultExtension? string 입력한 파일 이름이 없을 때 사용되는 확장자를 설정합니다.